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1.1  MODEL  4  THEORY  OF  OPERATION 


1.1.1  Introduction 

The  TRS  80  Model  4  Microcomputer  is  a  self  contained 
desktop  microcomputer  designed  not  only  to  be  completely 
software  compatible  with  the  TRS  80  Model  III,  but  to  pro 
vide  many  enhancements  and  features  System  distinctions 
which  enable  the  Model  4  to  be  Model  III  compatible 
include  a  Z80  CPU  capable  of  running  at  a  4  MHz  clock 
rate,  BASIC  operating  system  in  ROM  (14K),  memory 
mapped  keyboard,  64  character  by  16  line  memory  mapped 
video  display,  up  to  128K  Random  Access  Memory,  cassette 
circuitry  able  to  operate  at  500  or  1500  baud,  and  the 
ability  to  accept  a  variety  of  options  These  options  include 
one  to  four  5  1/4  inch  double  density  floppy  disk  drives,  one 
to  four  five  megabyte  hard  disk  drives,  an  RS  232  Serial 
Communications  Interface,  and  a  640  by  240  pixel  high 
resolution  graphics  board 

1.1.2  CPU  and  Timing 

The  central  processing  unit  of  the  Model  4  microcomputer 
is  the  Z80  A  microprocessor  —  capable  of  running  at  either 
a  two  (2  02752)  or  four  (4  05504)  MHz  clock  rate  The  main 
CPU  timing  comes  from  the  20  MHz  (20  2752  MHz}  crystal 
controlled  oscillator,  Y1  and  Q1  There  is  an  additional 
12  MHz  (12  672  MHz)  oscillator,  Y2  and  02,  which  is 
necessary  for  the  80  by  24  mode  of  video  operation  The 
oscillator  outputs  are  sent  to  two  Programmable  Array 
Logic  (PAL)  circuits,  U3  and  U4,  for  frequency  division 
and  routing  of  appropriate  timing  signals 

PAL  U3  divides  the  20  MHz  signal  by  five  for  4  MHz  CPU 
operation,  by  ten  for  a  2  MHz  rate,  and  slows  the  4  MHz 
clock  for  the  M1  Cycle  (See  Figure  1  -3)  U3  also  divides  the 
master  clock  by  four  to  obtain  a  5  MHz  clock  to  be  sent  to 
the  RS-232  option  connector  as  a  reference  for  the  baud 
rate  generator  PAL  U4  selects  an  appropriate  10  MHz  or  12 
MHz  clock  for  the  video  shift  clock,  and  using  divider  U5 
provides  additional  timing  signals  to  the  video  display  cir- 
cuitry (See  Fig  1  -4) 

Hex  latch  U18  is  clocked  from  the  20  MHz  clock,  and  is 
used   to   provide   MUX   and  CAS  timing  for  the  dynamic 


Port  Addr.  (Hex) 


Read  Function 


memory  circuits  Also,  with  additional  gates  from  U16, 
U19,  U20,  U31,  and  U32,  this  chip  provides  the  wait  cir 
cuitry  necessary  to  prevent  the  CPU  from  accessing  video 
RAM  during  the  active  portion  of  the  display  This  is  done 
by  latching  the  data  for  the  video  RAM  and  simultaneously 
forcing  the  Z80  CPU  into  a  "WAIT"  state  and  is  necessary 
to  eliminate  undesirable  "hashing"  of  the  video  display 
(See  Fig   1-4) 

1.1.3  Buffering 

Low  level  signals  from  and  to  the  CPU  need  to  be  buffered, 
or  current  amplified  in  order  to  drive  many  other  circuits 
The  16  address  lines  are  buffered  by  U55  and  U56,  which  are 
unidirectional  buffers  that  are  permanently  enabled  The 
eight  data  lines  are  buffered  by  U71  Since  data  must  flow 
both  to  and  from  the  CPU,  U71  is  a  bi  directional  buffer 
which  can  go  into  a  three  state  condition  when  not  in  use 
Both  direction  and  enable  controls  come  from  the  address 
decoding  section 

The  clock  signal  to  the  CPU  (from  PAL  U3}  is  buffered  by 
active  pullup  circuit  Q3  RESET  and  WAIT  inputs  to  the 
CPU  are  buffered  by  U17  and  U46  Control  outputs  from 
the  Z80  (M1*.  RD*.  WR*.  MREQ*,  and  IORQ*}  are  sent 
to  PAL  U58,  which  combines  these  into  other  appropriate 
control  signals  consistent  with  Model  4's  architecture  Other 
than  MREQ*,  which  is  buffered  by  part  of  U38,  the  raw 
control  signals  go  to  no  other  components,  and  hence  require 
no  additional  buffering 

1.1.4  Address  Decoding 

The  address  decoding  section  is  divided  into  two  sub 
sections  Port  address  decoding  and  Memory  address 
decoding 

In  port  address  decoding,  low  order  address  lines  (some 
combined  through  a  portion  of  U32)  are  sent  to  the  address 
and  enable  inputs  of  U48,  U49,  and  U50  U48  is  also  enabled 
by  the  IN*  signal,  which  means  that  is  decodes  port  input 
signals,  while  U49  decodes  port  output  signals  A  table  of 
the  resulting  port  map  is  shown  below 

Write  Function 


FC    FF 


F8 

FB 

(1) 

F4 

F7 

(1) 

F3 

(1) 

F2 

(1)    F1 


Cassette  In,  Mode  Read 

Read  Printer  Status 

reserved 
FDC  Data  Reg 
FDC  Sector  Reg 
FDC  Track  Reg 


Cassette  Out,  resets 
cassette  data  latch 
Output  to  Printer 
Drive  Select  latch 
FDC  Data  Reg 
FDC  Sector  Reg 
FDC  Track  Reg. 
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(1)  F0 
EC-EF 

(2)  EB 
(2)  EA 
(2)  E9 
(2)    E8 


E4  •  E7 
E0-E3 

(3)    CF 

(3)    CE 

(3)   CD 

(3)   CC 

(3)    CB 

(3)   CA 

(3)   C9 

(3)   C8 

(3)   C7 

(3)   C6 

(3)   C5 

(3)    C4 

(3)    C2-C3 

(3)  C1 
<3)    CO 

94-9F 

(4)  90-93 

(5)  8C 
SB 
8A 
89 
88 
84-87 

(5)  83 
(5)  82 
(5)  81 
(5)   80 


8F 


FDC  Status  Reg. 
Resets  RTC  Int. 
Rcvr  Holding  Reg. 
UART  Status  Reg. 

-  reserved  - 
Modem  Status 

Read  NMI  Status 
Read  INT  Status 
HD  Status 
HD  Size/Drv/Hd 
HD  Cylinder  high 
HD  Cylinder  low 
HD  Sector  Number 
HD  Sector  Count 
HD  Error  Reg. 
HD  Data  Reg. 
HD  CTC  channel  3 
HD  CTC  channel  2 
HD  CTC  channel  1 
HD  CTC  channel  0 
HD  Device  ID  Reg. 
HD  Control  Reg. 
HD  Wr.  Prot.  Reg. 

•  reserved  - 

-  reserved  - 
Graphics  Sel.2 
CRTC  Data  Reg. 
CRTC  Control  Reg. 
CRTC  Data  Reg. 
CRTC  Control  Reg. 

-  reserved  - 

-  reserved  - 

•  reserved  - 
Graphics  Ram  Rd. 

-  reserved  - 


FDC  Command  Reg. 
Mode  Output  latch 
Xmit  Holding  Reg. 
UART/Modem  control 
Baud  Rate  Register 
Master  Reset/Enable 
UART  control  reg. 
Write  NMI  Mask  reg. 
Write  INT  Mask  reg. 
HD  Command 
HD  Size/Drv/Hd 
HD  Cylinder  high 
HD  Cylinder  low 
HD  Sector  Number 
HD  Sector  Count 
HD  Write  Precomp. 
HD  Data  Reg. 
HD  CTC  channel  3 
HD  CTC  channel  2 
HD  CTC  channel  1 
HD  CTC  channel  0 

-  reserved  • 

HD  Control  Reg. 

-  reserved  - 

-  reserved  - 
Sound  Option 
Graphics  Sel.  2 
CRTC  Data  Reg. 
CRTC  Control  Reg. 
CRTC  Data  Reg. 
CRTC  Control  Reg. 
Options  Register 
Gra.  X  Reg.  Write 
Gra.  Y  Reg.  Write 
Graphics  Ram  Wr. 
Gra.  Options  Reg.  Wr 


Notes:      (1)  Valid  only  if  FDC  option  is  installed 

(2)  Valid  only  if  RS-232  option  is  installed 

(3)  Valid  only  if  Hard  Disk  option  is  installed 

(4)  Valid  only  if  sound  option  is  installed 

(5)  Valid  only  if  High  Resolution  Graphics  option  is  installed 
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Following  is  a  Bit  Map  of  the  appropriate  ports  in  the  Model  4.  Note  that  this  is  an  "internal"  bit  map  only.  For  bit  maps  of  the 
optional  devices,  refer  to  the  appropriate  section  of  the  desired  manual. 


Port 

D7 

FC  •  FF 

Cass 

(READ) 

data 

500  bd 

FC-FF 

(WRITE) 

X 

F8-  FB 

Prntr 

(READ) 

BUSY 

F8-FB 

Prntr 

(WRITE) 

D7 

EC-EF 


D6 


Model  4  Port  Bit  Map 
D5  D4  D3 

(MIRROR   of  PORT      EC} 
(Note,  also  resets  cassette  data  latch) 


02 


D1 


Prntr 
Paper 

Prntr 
D6 


Prntr 
Select 

Prntr 
D5 


Prntr 
Fault 

Prntr 
D4 


X 
X 

Prntr 
D3 


x 

X 

Prntr 
D2 


out 

X 

X 

Prntr 
D1 


(Any  Read  causes  reset  of  Real  Time  Clock  Interrupt) 


DO 

Cassette 

data 
1500  bd 

cassette 

data  out 

x 
x 

Prntr 
DO 


EC-EF 

X 

CPU 

X 

Enable 

Enable 

Mode 

Cass 

X 

(WRITE) 

X 

Fast 

X 

EX  I/O 

Altset 

Select 

Mot  On 

X 

E0-E3 

X 

Receive 

Receive 

Xmit 

10  Bus 

RTC 

CFat! 

C  Rise 

(READ) 

X 

Error 

Data 

Empty 

Irtt 

Int 

Int 

fnt 

E0-E3 

X 

Enable 

Enable 

Enable 

Enable 

Enable 

Enable 

Enable 

(WRITE) 

X 

Rec  Err 

Rec  Data 

Xmit  Emp 

10  Int 

RTlnt 

CF  Int 

CR  Int 

90-93 

X 

X 

X 

X 

X 

X 

X 

Sound 

(WRITE) 

X 

X 

X 

X 

X 

X 

X 

Bit 

84-87 

Page 

Fix  Upr 

Memory 

Memory 

Invert 

80/64 

Select 

Select 

(WRITE) 

Memory 

Bit  1 

Sit  0 

Video 

Bit  1 

BitO 

c 


Memory  mapping  is  accomplished  by  PAL  U59  in  the  Basic  16K  or  64K  computer.  In  a  128K  system,  PAL  U72,  along  with  the 
select  and  memory  bits  of  the  options  register,  also  enter  into  the  memory  mapping  function. 

Four  memory  maps  are  listed  below.  Memory  Map  I  is  compatible  with  the  Model  III.  Note  that  there  are  two  32K  banks  in  the 
64K  system,  which  can  be  interchanged  with  either  position  of  the  upper  two  banks  of  a  128K  system.  The  128K  system  has 
four  moveable  32K  banks.  Also  note,  in  the  Model  111  mode,  that  decoding  for  the  printer  status  read  (37E8and  37E9  hexadeci- 
mal) is  accomplished  by  U93  and  leftover  gates  from  U40,  U46,  U51,  U54,  U60,  and  U62. 

Memory  Map  I  —  Model  III  Mode 


0000- 1FFF 

ROMA  (8K) 

2000-2FFF 

ROMB(4K) 

3000-37FF 

ROM  C  (2K)  -  Less  37E8  -  37E9 

37E8-37E9 

Printer  Status  Port 

3800-  3  BFF 

Keyboard 

3C00-3FFF 

Video  RAM  (Page  bit  selects  1  K  of  2K) 

4000-  7FFF 

RAM  (16K  system) 

4000  -FFFF 

RAM  (64K  system) 
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Memory  Map  II 


0000-37FF 
3800-3BFF 
3CO0-3FFF 
4000-7FFF 

8000 -FFFF 


0000-7FFFF 

8000-F3FF 
F400  -  F7FF 
F800-  FFFF 


RAM  (14K) 
Keyboard 
Video  RAM 
RAM  (16K) 

RAM  (32K) 

Memory  Map  III 

RAM  (32K) 

RAM  (29K) 
Keyboard 
Video  RAM 


End  of  one32K  Bank 
Second  32K  Bank 

End  of  One  32 K  Bank 
Second  32K  Bank 


1.1.5  ROM 


0000  -  7FFF 
8000-  FFFF 


Memory  Map  IV 

RAM  (32K) 
RAM  (32K) 


One  32K  Bank 
Second  32K  Bank 


(See  Figure  1  -2  for  1 28K  Maps) 


The  Model  4  Microcomputer  contains  14K  of  Read  Only 
Memory  (ROM),  which  is  divided  into  an  8K  ROM  (U68),  a 
4K  ROM  (U69),  and  a  2K  ROM  (U70).  ROMs  used  have 
three-state  outputs  which  are  disabled  if  the  ROMs  are 
deselected.  As  a  result,  ROM  data  outputs  are  connected 
directly  to  the  CPU  data  bus  and  do  not  use  data  buffer 
U71,  which  is  disabled  during  a  ROM  access. 

ROMs  are  Model  III  compatible  and  contain  a  BASIC  opera- 
ting system,  as  well  as  a  floppy  disk  boot  routine.  The  enable 
inputs  to  the  ROMs  are  provided  by  the  address  decoding 
section,  and  are  present  only  in  the  Model  III  mode  of 
operation. 

1.1.6  RAM 

Three  configurations  of  Random  Access  Memory  are  avail- 
able on  the  Model  4:  16K,  64K,  and  128K.  The  16K  option 
uses  4116  type,  16K  by  1  dynamic  RAMs,  which  require 
three  supply  voltages  (+12  volts,  +5  volts,  and  —5  volts). 
The  64K  and  128K  options  use  6665  type,  64K  by  1  dyna- 
mic RAMs,  which  require  only  a  single  supply  voltage  (+5 
volts).  The  proper  voltage  for  each  option  is  provided  by 
jumpers. 

Dynamic  RAMs  require  multiplexed  incoming  address  lines. 
This  is  accomplished  by  ICs  U63  and  U76.  Output  data 
from  RAMs  is  buffered  by  U64.  With  the  128K  option,  there 
are  two  rows  of  the  64K  by  1  RAM  ICs.  The  proper  row  is 
selected  by  the  CAS*  signal  from  PAL  U72. 


1.1.7  Keyboard 

The  Model  4  Keyboard  is  a  70-key  sculptured  keyboard, 
scanned  by  the  microprocessor.  Each  key  is  identified  by 
its  column  and  row  position.  Columns  are  defined  by  address 
lines  A0  -  A7,  which  are  buffered  by  open-collector  drivers 
U29  and  U30.  Data  lines  DO  -  D7  define  the  rows  and  are 
buffered  by  CMOS  buffers  U44  and  U45.  Row  inputs  to  the 
buffers  are  pulled  up  by  resistor  pack  RP  1,  unless  a  key 
in  the  current  column  being  scanned  is  depressed.  Then, 
the  row  for  that  key  goes  low. 

1.1.8  Video 

The  heart  of  the  video  display  circuitry  in  the  Model  4  is 
the  68045  Cathode  Ray  Tube  Controller.  The  CRTC  allows 
two  screen  formats:  64  by  16  and  80  by  24.  Since  the  80 
by  24  screen  requires  1,920  screen  memory  locations,  a 
2K  by  8  static  RAM  is  used  for  the  Video  RAM.  The  64 
by  16  mode  has  a  two-page  screen  display  and  a  bit  in  the 
options  register  for  determining  which  page  is  active  for 
the  CPU.  Offset  the  start  address  of  the  CRTC  to  gain 
access  to  the  second  page  in  the  64  by  16  mode. 

Addresses  to  the  video  RAM  are  provided  by  the  68045 
when  refreshing  the  screen  and  by  the  CPU  when  updating 
the  data.  These  two  sets  of  addresses  are  multiplexed  by 
U33,  U34.  and  U35.  Data  between  the  CPU  and  Video 
RAM  is  latched  by  U6  for  a  write,  and  buffered  by  U7  for 
a  read  operation. 
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FIGURE  1-2.  RAM  MEMORY 
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During  screen  refresh,  the  data  outputs  of  the  Video  RAM 
(ASCII  character  codes)  are  latched  by  U8  and  become  the 
addresses  for  the  character  generator  ROM  (U23)  In  cases 
of  low  resolution  graphics  a  dual  1  of  4  data  selector  (U9) 
is  the  cell   generator    with  additional   buffering  from   U10 

The  shift  register  U11  inputs  are  the  latched  data  outputs 
of  the  character  or  cell  generator  The  shift  clock  input 
comes  from  the  PAL  U4,  and  is  10  1376  MHz  for  the  64 
by  16  mode  and  12  672  MHz  for  80  by  24  operation  The 
serial  output  from  the  shift  register  later  becomes  actual 
video  dot  information 

Special  timing  in  the  video  circuit  is  handled  by  hex  latch 
U2  This  includes  blanking  (originating  from  CRTC)  and 
shift  register  loading  (originating  from  U4)  Additional 
video  control  and  timing  functions,  such  as  sync  buffering, 
inversion  selection,  dot  clock  chopping,  and  graphics  disable 
of  normal  video  are  handled  by  miscellaneous  gates  in  U12, 
U13,  U14,  U22,  U24,  and  U26 

1.1.9  Reat  Time  Clock 

The  Real  Time  Clock  circuit  in  the  Model  4  provides  a  30 
Hz  (in  the  2  MHz  CPU  Mode)  or  60  Hz  (in  the  4  MHz  CPU 
Mode)  interrupt  to  the  CPU  By  counting  the  number  of 
interrupts  that  have  occured,  the  CPU  can  keep  track  of  the 
time  The  60  Hz  vertical  sync  signal  from  the  video  circuitry 
is  divided  by  two  (2  MHz  Mode)  by  U53,  and  the  30  Hz  at 
pin  1  of  U51  is  used  to  generate  the  interrupts  In  the  4 
MHz  mode,  signal  FAST  places  a  logic  low  at  pin  1  of  U51, 
causing  signal  VSYNC  to  trigger  the  interrupts  at  the  60  Hz 
rate  Note  that  any  time  interrupts  are  disabled,  the  accuracy 
of  the  clock  suffers 

1.1.10  Cassette  Circuitry 

The  cassette  write  circuitry  latches  the  two  LSBs  (DO  and 
01  r  for  any  output  to  port  FF  (hex)  The  outputs  of  these 
latches  (U27)  are  then  resistor  summed  to  provide  three 
discrete  voltage  levels  (500  Baud  only)  The  firmware  toggles 
the  bits  to  provide  an  output  signal  of  the  desired  frequency 
at  the  summing  node 

There  are  two  types  of  cassette  Read  circuits  -  500  baud  and 
1500  baud  The  500  baud  circuit  is  compatible  with  both 
Model  1  and  III  The  input  signal  is  amplified  and  filtered 
by  Op  amps  (U43  and  U28  Part  of  U15  then  forms  a 
Zero  Crossing  Detector,  the  output  of  which  sets  the  latch 
U40  A  read  of  Port  FF  enables  buffer  U41,  which  allows 
the  CPU  to  determine  whether  the  latch  has  been  set,  and 
simultaneously  resets  the  latch  The  firmware  determines 
by  the  timing  between  settings  of  the  latch  whether  a  logic 
"one"  or  "zero"  was  read  in  from  the  tape 


The  1500  baud  cassette  read  circuit  is  compatible  with  the 
Model  111  cassette  system  The  incoming  signal  is  compared 
to  a  threshold  by  part  of  U15  U15's  output  will  then  be 
either  high  or  low  and  clock  about  one  half  of  U39,  depend 
ing  on  whether  it  is  a  rising  edge  or  a  falling  edge  If 
interrupts  are  enabled,  the  setting  of  either  latch  will  gene 
rate  an  interrupt  As  in  the  500  baud  circuit,  the  firmware 
decodes  the  interrupts  into  the  appropriate  data 

For  any  cassette  read  or  write  operation,  the  cassette  relay 
must  be  closed  in  order  to  start  the  motor  of  the  cassette 
deck  A  write  to  port  EC  hex  with  bit  one  set  will  set  latch 
U42,  which  turns  on  transistor  Q4  and  energizes  the  relay 
K1  A  subsequent  write  to  this  port  with  bit  one  clear 
will  clear  the  latch  and  de  energize  the  relay 

1.1.11  Printer  Circuitry 

The  printer  status  lines  are  read  by  the  CPU  by  enabling 
buffer  U67  This  buffer  will  be  enabled  for  any  input  from 
port  F8  or  F9,  or  any  memory  read  from  location  37  E8 
or  37E9  when  in  the  Model  III  mode  For  a  listing  of  bit 
status,  refer  to  the  bit  map 

After  the  printer  driver  software  determines  that  the  printer 
is  ready  to  receive  another  character  (by  reading  the  status), 
the  character  to  be  printed  is  output  to  port  F8  This  latches 
the  character  into  U66,  and  simultaneouly  fires  the  one  shot 
U65  to  provide  the  appropriate  strobe  to  the  printer 

1.1.12  I/O  Connectors 

Two  20  pin  single  inline  connectors,  J7  and  J8,  are  provided 
for  the  connection  of  a  Floppy  Disk  Controller  and  an 
RS  232  Communications  Interface,  respectively  All  eight 
data  lines  and  the  two  least  significant  address  lines  are 
routed  to  these  connectors  In  addition,  connections  are 
provided  for  device  or  board  selection,  interrupt  enable, 
interrupt  status  read,  interrupt  acknowledge,  RESET,  and 
the  CPU  WAIT  signal 

The  graphics  connector,  J10,  contains  all  of  the  above  inter 
face  signals,  plus  CRTCLK,  the  dotclock  signal,  a  graphics 
enable  input,  and  other  timing  clocks  which  synchronize 
the  graphics  board  with  the  CRTC. 

The  I/O  bus  connector,  J2,  contains  connections  for  alt 
eight  data  lines  (buffered  by  U74),  the  low  order  address 
lines  (buffered  by  U73),  and  the  control  lines  (buffered  by 
U75)  IN*,  OUT*,  RESET*,  M1*,  and  IORQ*  In  addition, 
the  I/O  bus  connector  has  inputs  to  allow  the  device(s), 
connected    to   generate   CPU    WAIT  states   and    interrupts 
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The  sound  connector,  J11,  contains  only  four  connections: 
sound  enable  (any  output  to  port  90  hex),  data  bit  DO, 
Vcc,  and  ground. 

1.1.13  Sound  Option 

The  Model  4  sound  option,  available  as  standard  equipment 
on  the  disk  drive  versions,  is  a  software  intensive  device.  Data 


is  sent  out  to  port  90H,  alternately  setting  and  clearing 
data  bit  DO.  The  state  of  this  bit  is  latched  by  sound  board 
U1  and  amplified  by  sound  board  0.1,  which  drives  a  pie- 
zoelectric sound  transducer.  The  speed  of  the  software 
loop  determines  the  frequency,  and  thus,  the  pitch  of  the 
resulting  tone. 
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1.2  MODEL  4  I/O  BUS 


The  Model  4  Bus  is  designed  to  allow  easy  and  convenient 
interfacing   of   I/O  devices   to  the  Model  4    The  I/O  8us 
supports  all  the  signals  necessary  to  implement  a  device  com 
patible  with  the  Z  80s  I/O  structure  That  is 

Addresses 

A0  to  A7  allow  selection  of  up  to  256*  input  and  256 
output  devices  if  external  I/O  is  enabled 

'Ports  80H  to  0FFH  are  reserved  for  System  use 

Data 

DB0  to  DB7  allow  transfer  of  8  bit  data  onto  the  pro 
cessor  data  bus  if  external  I/O  is  enabled 


For  input  port  device  use  you  must  enable  external  I/O  de 
vices  by  writing  to  port  0ECH  with  bit  4  on  in  the  user  soft 
ware  This  will  enable  the  data  bus  address  lines  and  control 
signals  to  the  I/O  Bus  edge  connector  When  the  input  de- 
vice is  selected  the  hardware  will  acknowledge  by  asserting 
EXTIOSEL"  low  This  switches  the  data  bus  transceiver  and 
allows  the  CPU  to  read  the  contents  of  the  I/O  Bus  data 
lines  See  Figure  1  6  for  the  timing  EXTIOSEL*  can  be  gen- 
erated by  NAN  Ding  IN  and  the  I/O  port  address 

Output  port  device  use  is  the  same  as  the  input  port  device  in 
use  in  that  the  external  I/O  devices  must  be  enabled  by  writ 
ing  to  port  0ECH  with  bit  4  on  in  the  user  software  —  in  the 

same  fashion 


Control  Lines 

a       IN*  —  Z  80  signal  specifying  that  an  input  is  in  pro 

gress  Gated  with  IORQ 
b      OUT*  —  Z  80  signal  specifying  that  an  output  is  in 

progress  Gated  with  IORQ 
c       RESET*  —  system  reset  signal 
d       IOBUSINT*  -  input  to  the  CPU  signaling  an  inter 

rupt  from  an  I/O  Bus  device  if  I/O  Bus  interrupts 

are  enabled 
e       IOBUSWAIT*  -  input  to  the  CPU  wait  line  allow 

ing  I/O  Bus  device  to  force  wait  states  on  the  Z  80 

if  external  I/O  is  enabled 
f       EXTIOSEL*  -  input  to  CPU  which  switches  the 

I/O  Bus  data  bus  transceiver  and  allows  an  INPUT 

instruction  to  read  I/O  Bus  data 
g       Ml*  -  and  IORQ*  -  standard  Z  80  signals 

The  address  line,  data  line,  and  control  lines  a  to  c  and  e  to  g 
are  enabled  only  when  the  EN  EX  10  bit  in  EC  is  set  to  a  one 


For  either  input  or  output  devices,  the  IOBUSWAIT*  control 
line  can  be  used  in  the  normal  way  for  synchronizing  slow 
devices  to  the  CPU  Note  that  since  dynamic  memories  are 
used  in  the  Model  4,  the  wait  line  should  be  used  with  cau 
tion  Holding  the  CPU  in  a  wait  state  for  2  msec  or  more  may 
cause  loss  of  memory  contents  since  refresh  is  inhibited  during 
this  time  It  is  recommended  that  the  IOBUSWAIT*  line  be 
held  active  no  more  than  500  ^isec  with  a  25%  duty  cycle 

The  Model  4  will  support  Z  80  mode  1  interrupts  A  RAM 
jump  table  is  supported  by  the  LEVEL  II  BASIC  ROMs  and 
the  user  must  supply  the  address  of  his  interrupt  service 
routine  by  writing  this  address  to  locations  403E  and  403F 
When  an  interrupt  occurs  the  program  will  be  vectored  to 
the  user  supplied  address  if  I/O  Bus  interrupts  have  been 
enabled  To  enable  I/O  Bus  interrupts  the  user  must  set  bit 
3  of  Port  0E0H 


c 


To  enable  I/O  interrupts  the  EN  IOBUSINT  bit  in  the  CPU 
IOPORT  E0  (output  port)  must  be  a  one  However,  even  if 
it  is  disabled  from  generating  interrupts  the  status  of  the 
IOBUSINT*  line  can  still  read  on  the  appropriate  bit  of  CPU 
IOPORT  E0  {input  port) 

See  Model  4  Port  Bit  assignment  for  port  OFF  0  EC  and 
0E0  on  pages  14  and  15 

The  Model   4  CPU  board  is  fully  protected  from  "foreign 
I/O  devices"  in  that  all  the  I/O  Bus  signals  are  buffered  and 
can  be  disabled  under  software  control  To  attach  and  use  an 
I/O  device  on  the  I/O  Bus  certain  requirements  (both  hard 
ware  and  software)  must  be  met 
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1.3  MODEL  4  PORT  BITS 


Name:  WRNMIMASKREG  * 

Port  Address:      0E4H 
Access:  WRITE  ONLY 

Bit  7  =  ENINTRQ;    0  disables  Disk  INTRQ  from  generating 
anNMI. 
1  enables  above. 

Bit  6  =  ENORQ;     0  disables  Disk  DRQ  from  generating  an 
NMI. 
1  enables  above. 

Name:  RDNMISTATUS" 

Port  Address:      0E4H 
Access:  READONLY 

Bit  7  =  Status  of  Disk  INTRQ;   1  =  False,  0  =  True 

Bit  6  =  Status  of  Disk  DRQ;   1  =  False,  0  =  True 

Bit  5  =  Reset*  Status;    1  =  False,©  =  True 

Name:  MOD  OUT 

Port  Address:      0ECH 
Access:  WRITE  ONLY 

Bit  7  -  Undefined 

Bit  6=  Undefined 

Bit  5  =  DISWAIT;  0  disables  video  waits,  1  enables 

Bit  4  =  ENEXTIO;  0  disables  external  IO  Bus,  1  enables 

Bit  3  =  ENALTSET;  0  disables  alternate  character  set, 
1  enables  alternate  video  character  set. 

Bit  2  =  MODSEL;  0  enables  64  character  mode, 
1  enables  32  character  mode. 

Bit  1  =  CASMOTORON;  0  turns  cassette  motor  off, 
1  turns  cassette  motor  on. 

Bit  0  =  Undefined 


Name:  RDINTSTATUS' 

Port  Address:      0E0H 
Access:  READONLY 

NOTE:    A  0  indicates  the  device  is  interrupting. 


t  7  =  Undefined 

t  6=  RS-232  ERROR  INT 

t  5  =  RS-232  RCV  INT 

t  4  =  RS-232  XMIT  INT 

t  3=  IOBUS  INT 

t2  =  RTC  INT 

t  1  =  CASSETTE  (1500  Baud)      INT  F 

t  0  =  CASSETTE  (1500  Baudl      INT  R 


Name:  CASOUT* 

Port  Address:      0FFH 
Access:  WRITE  ONLY 

Bit  7  =  Undefined 

Bit  6  =  Undefined 

Bit  5  =  Undefined 

Bit  4  =  Undefined 

Bit  3  =  Undfined 

Bit  2  -  Undefined 

Bit  1  =  Cassette  output  level 

Bit  0  =  Cassette  output  level 


c 
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Name  WRINTMASKREG " 

Port  Address       0E0H 

Access  WRITE  ONLY 

Sit  7  =  Undefined 

Bit  6  =  ENERROR1NT     1  enables  RS  232  interrupts  on  par 
itv  error,  framing  error,  or  data  overrun  error 
0  disable  above 

Bit  5  =  ENRCVINT,     1  enables  RS232  receive  data  register 
full  interrupts, 
0  disables  above 

Bit  4  =  ENXMITINT      1  enables  RS  232  transmitter  holding 
register  empty  interrupts, 
0  disables  above 

Bit  3  =  ENIOBUSINT,  1  enables  I/O  Bus  interrupts, 
0  disables  the  above 

Bit  2  =  ENRTC,    1  enables  real  time  clock  interrupt, 
0  disables  above 


Name  ORVSEL* 

Port  Address       0F4H 

Access  WRITE  ONLY 

Bit  7  =  FM  7MFM    0  selects  single  density, 
1  selects  double  density 

Bit  6  =  WSGEN,  0  -  no  wait  states  generated, 
1  =  wait  states  generated 

Bit  5  =  PRECOMP,  0  =  no  write  precompensation, 
1  =  write  precompensation  enabled 

Bit  4  =  SOSE  L,  Q  selects  side  0  of  diskette, 
1  selects  side  1  of  diskette 

Bit  3  =  Drive  select  4 

Bit  2  =  Drive  select  3 

Bit  1  =  Drive  select  2 

Bit  0  =  Drive  select  1 


Bit  1  =  ENCASINTF,    1  enables  1500  Baud  falling  edge  inter 
rupt, 
0  disables  above 

Bit  0  =  ENCASINTR      1  enables  1500  Baud  rising  edge  inter 
rupt, 
0  disables  above 


Name  CAS  IN* 

Port  Address        0FFH 
Access  READONLY 

Bit  7  =  500  Baud  Cassette  bit 

Bit  6  =  Undefined 

Bit  5  =  DISWAIT    (See  Poit  0ECH  definition) 

Bit  4  =  ENEXTIO    (See  Port  0ECH  definition! 

Bit  3  =  ENALTSET    (See  Port  0ECH  definition) 

Bit  2  -  MODSEL   (See  Port  0ECH  definition) 

Bit  1  =  CASMOTORON    (See  Port  0ECH  definition) 

Bit  0  =  1500  Baud  Cassette  bit 

NOTE       Reading  Port  0FFH  clears  the  1500  Baud  Cassette 
interrupts 
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2.1  MODEL  4  GATE  ARRAY  THEORY  OF 
OPERATION 

2.1.1  Introduction 

The  following  discusses  each  element  of  the  main  board  of 
the  Model  4  Gate  Array  block  diagram  (see  Figure  2-1)  In 
each  case  the  intent  is  understanding  the  operation  on  a 
practical  level  sufficient  to  aid  in  isolating  a  problem  to  the 
falling  component 

2.1.2  Reset  Circuit 

Figure  2-2  shows  the  Reset  circuit  for  generation  of  reset  on 
power  up  and  when  the  reset  switch  is  pushed  on  the  key- 
board The  time  constant  determined  by  R8  and  C25,  is 
used  to  allow  the  system  to  stabilize  before  triggering  a  one 
shot  (U63)  with  an  approximate  pulse  width  of  70  microsecs 
When  the  reset  switch  is  pushed,  the  input  pin  is  brought  to 
ground  and  fires  the  one  shot  when  the  switch  is  released 

A  second  point  to  be  noted  is  the  signal  POWRS*  which  is 
used  to  reset  the  dnve  selecl  latch  in  the  FDC  circuit 

2.1.3  CPU 

The  central  processing  unit  of  the  Model  4  microcomputer  is 
a  Z80A  microprocessor,  and  will  run  in  either  2  or  4  MHz 
mode  All  of  the  output  lines  of  the  Z80A  are  buffered  The 
address  lines  are  buffered  by  two  74LS244s  (U2  and  U3 
with  the  enable  tied  to  ground),  the  control  lines  by  a  74F04 
(U27),  and  the  data  lines  by  a  74LS245  (U28  with  the  ena- 
ble tied  to  BUSEN*  and  the  direction  control  tied  to 
BUSDIR*) 

2.1.4  System  Timing  and  Control  Registers 
Control  Registers 

The  first  of  these  registers  is  the  WRINTMASKREG  (U34) 
This  is  onty  part  of  the  register  as  this  function  is  shared 
with  the  Gate  Array  4  5  The  main  register  contains  RTC 
ENCASINTFALL  AND  ENCASINTRISE  The  Gate  Array  has 
the  interrupts  for  the  RS232C  Interface  and  the  I/O  bus  in- 
terrupts and  a  duplicate  of  the  RTC 


CPU  Clock  and  RS232  Clock 

Most  of  the  timing  generation  for  the  board  is  shown  in  Fig- 
ure 2-5  The  Gate  Array  4  1  1  is  the  basis  for  this  timing  as 
it  produces  the  20  2752  MHz  clock  and  then  divides  this 
down  to  produce  most  of  the  other  clocking  functions  used 
on  the  board 

The  first  clock  that  is  produced  is  PCLK  (pin  23)  which 
dnves  the  CPU  It  is  a  divide  by  ten  of  the  20  2752  MHz  in 
the  2  MHz  mode  and  a  divide  by  5  in  the  4  MHz  mode  The 
transition  from  one  mode  to  the  other  is  without  glitches  and 
both  modes  are  50  percent  duty  cycles 

Note  that  the  signal  that  controls  this  mode  also  controls  the 
Real  Time  Clock  circuit  described  later. 

As  a  simple  divide  by  four  of  the  fundamental  20  2752  MHz, 
the  RS232CLK  on  pm  22  of  U9  provides  the  basic  clock  to 
the  RS232C  circuit 

Video  and  Graphics  Clocking  and  Timing 

The  timing  for  both  of  these  functions  may  be  viewed  as  one 
since  they  must  operate  synchronously  and  the  same  timing 
must  be  generated  for  both  The  additional  signals  sent  to 
the  Graphics  Board  allow  it  to  maintain  synchronization  by 
knowing  the  phase  relation  of  the  signals  sent  to  both  of 
them  To  further  understand  the  circuit  of  Figure  2-5  notice 
the  PLL  Module  (U8)  This  chip  develops  a  12  672  MHz  sig- 
nal which  is  phase  locked  to  the  1  2672  MHz  input  on  pin  5 
and  is  a  divide  by  16  of  the  primary  20  2752  MHz  clock 
This  provides  the  Gate  Array  4  11  with  two  clocks  to  drive 
the  video  display  and  the  graphics  circuits,  10  1376  MHz  for 
64  character  display,  and  a  12  672  MHz  for  the  80  character 
display 

The  following  discussion  will  consider  both  the  64  and  80 
character  displays  to  be  the  same,  the  difference  being  the 
primary  frequency  and  not  the  phase  relation  or  function  of 
the  signals  generated 


The  second  is  the  OPREG  (U33)  which  contains  the  added 
options  of  the  Model  4  for  video  and  Memory  mapping 

The  last  of  the  registers  is  MODOUT  (U53)  and  is  also  read- 
able through  the  CASSIN  (U52)  buffer  It  contains  the  Cas- 
sette motion  controls,  and  the  FAST  control  for  Model  4 


The  reference  clock  for  the  timing  is  DCLK  (U9-1 5)  and  the 
other  clocks  that  are  produced  for  the  video  output  are  de- 
nved  from  this  clock  (DOT*  at  U9-17  is  a  phase  shift  of 
DCLK  and  is  provided  as  an  option  for  the  the  dot  clock  for 
variations  in  delay  paths  in  the  video  section)  U9  then  gen- 
erates SHIFT*  (pm  21),  XADR7*  (pin  20),  CRTCLK  (pin  19), 
LOADS*  (pin  18),  and  LOAD*  (pin  16)  for  the  proper  timing 
for  the  four  video  modes  In  addition  for  the  Graphics  Board 
to  synchronize  with  this  timing  H  (pin  14),  I  {pin  13),  and  J 
{pin  11)  are  fed  to  connector  J12  See  Figures  2-6  and  2-7 
for  the  timing  diagrams  for  video  clocks  generated  by  Gate 
Array  4  1  1 
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Figure  2-4.  Control  Registers 
(Page  2  of  Schematic) 


-> 


Figure  2-5.  CPU,  RS232C,  and  Video 

Timing  Generation 

(Page  3  of  Schematic) 
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DRAM  and  Video  RAM  Timing 


DRAM  Timing 


The  Video  RAM  and  DRAM  timing  share  the  timing  delay 
iine  (U80)  This  is  done  by  'OR'ing  the  two  signals  GRAS* 
and  AINPRG*  at  U39  to  get  the  signal  STOEL*  This  is  pos- 
sible because  the  signals  VIDEO  and  MREQ  or  MCYCEN 
are  gated  in  to  mask  off  the  signals  that  are  not  desired. 

Since  the  CRTC  and  the  CPU  are  operating  independently 
and  at  different  clock  rates,  when  the  CPU  wants  to  access 
the  Video  RAM  the  two  must  synchronize  with  each  other 
This  is  accomplished  when  a  video  access  is  decoded 
WAIT*  it  is  pulled  low,  when  it  is  determined  whether  the  ac- 
cess is  a  read  or  write  and  the  correct  cycle  of  the  CRTC 
clock  is  present,  the  actual  access  can  begin,  hence 
AINPRG*  is  generated  and  WAIT*  is  released 

From  this  point  the  actual  sequence  depends  on  whether  a 
read  or  a  write  is  done  On  a  read  the  address  is  enabled  to 
the  RAM,  the  delay  through  U80  to  VLATCH"  when  data  is 
latched  in  the  74LS373  where  the  CPU  can  pick-up  the  data 
at  the  completion  of  this  cycle  On  a  write  the  sequence  is 
more  complex  The  address  is  enabled  to  the  RAM,  the  oul- 
put  is  disabled  (VRAMDIS"  at  U7-12),  wnte  is  delayed  with 
respect  to  the  address  (DLYWR*  at  U60-6)  and  the  buffer  on 
the  data  lines  is  enabled  (VBUFEN"  at  U60-8),  then  after  a 
delay  the  write  is  cutoff  to  end  the  cycle  for  the  RAM 
(ENDVW*  at  U80-10)  For  the  timing  diagram  of  the  Video 
RAM  CPU  access  see  Figure  2-8 


The  DRAM  timing  is  shown  in  Figure  2-9  At  the  begming  of 
the  CPU  cycle  the  address  lines  settle-out  first  and  are, 
therefore,  decoded  to  allow  maximum  access  speed  {see 
Address  Decode)  With  the  generation  of  MREQ,  U39-11 
generates  PMREQ  and  enables  U42  and  gates  this  with  the 
type  Of  cycle  to  develop  GRAS*  (U30-6),  RASO*  (U30-3), 
and  RAS1*  (U30-11)  GRAS*  is  then  "OR'ed  with  AINPRG 
as  mentioned  above  The  timing  from  this  point  is  very 
straight  forward  With  RASO*  and  RAS1*  generated  next 
MUX  (U80-12)  is  built  to  switch  the  addresses  to  memory 
then  GCAS  is  generated  and  clocks  flip-flop  U31  with 
MCYEN  on  the  J  term  This  is  done  to  make  sure  this  is  a 
true  memory  cycle  Then  tf  this  is  an  M1  cycle  VLATCH" 
clocks  at  U31  and  cuts  off  PMREQ*  at  U39  to  end  the  cycle 
For  timing  diagrams  of  the  memory  interface  see  Figures  2- 
10  to  2-12 

2.1.5.  Address  Decode 

This  section  is  divided  into  two  parts,  the  memory  address- 
ing and  the  I/O  addressing  This  separation  is  a  reflection  of 
the  separate  mapping  of  memory  and  I/O  ol  the  Z80A  itself 
For  reference  of  both  sections,  see  Figure  2-13 

Memory  Address 

The  memory  map  for  the  Model  4  is  shown  in  Table  2-1  and 
is  best  described  as  an  option  overlay  in  the  sense  that  at 
each  step  of  additional  memory,  the  new  options  overlap  the 
previous  and  the  new  options  are  added  on  Moreover,  the 
added  options  have  no  effect  on  previous  levels  and  are  in- 
visible at  those  levels. 


MAPI* 


Address  in  hex 
MAP  II  MAP  III 


MAP  IV 


Function 
of  block 


O 


0000-37E7 

37E8-37E9 

37EA-37FF 

3800-3BFF 

3C00-3FFF* 

4000-7FFF 

4000-FFFF 


0000-37FF 


3800-3BFF 
3C00-3FFF" 

4000-FFFF 


0000-F3FF 


F400-F7FF 
F800-FFFF 


0000-FFFF 


RAM  (64K) 
ROM 

Printer  Status 
ROM 
Keyboard 
Video  RAM 
RAM  (16K) 
RAM  (64K) 


Table  2-1 


'  Only  map  available  on  16K  machine 
Page  bit  is  used  to  select  1 K  of  2K  Video  RAM 


The  decoding  ol  the  addresses  for  the  memory  map  de- 
scribed above  is  done  for  the  most  part  by  U5  The  only  de- 
code not  done  by  U5  is  the  line  printer  memory  status  port 
at  37E8  and  37E9  hex  These  needed  additional  address 
lines  hence  the  decode  LPADD  as  an  input  to  U5 
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Figure  2-9.  Video  RAM  and  DRAM  Timing  Circuit. 
(Page  2  of  Schematic) 
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I/O  port  Address 

The  Port  Map  decoding  is  accomplished  by  three  74LS138s 
<U43,U44,  and  U59)  These  ICs  decode  the  low  order  ad- 
dress lines  (AO  -  A7)  from  the  CPU  and  decode  the  port 
being  selected  The  IN*  signal  and  OUT*  signal  are  used  in 
the  decode  for  U59  and  U43,  but  U44  is  a  pure  address  de- 
code and,  therefore,  needs  to  be  gated  with  IN*,  OUT",  or 
IOREQ*  later  For  a  complete  I/O  map  see  Table  2-3 

2.1.6.  ROM 

The  A  ROM  is  enabled  by  the  decode  as  appropriate  by  the 
address  logic  described  above,  and  is  addressed  in  a  simple 
straight  forward  fashion  The  enable  for  the  B/C  ROM  is  also 
similarly  accomplished,  however,  the  address  has  a  jumper 
option  available  This  option  is  designed  to  allow  for  testing 
of  the  board  logic  in  the  factory  When  jumper  is  moved  from 
JP8  to  JP7,  the  ROM  is  in  the  test  mode,  with  the  options 
appearing  on  the  screen 

2.1.7  DRAM 

The  DRAM  timing  was  described  earlier  m  the  timing  sec- 
tion, the  actual  DRAM  is  contained  in  two  banks  of  eight 
each  U65  to  U74  and  U85  to  U92  They  are  arranged  in  or- 
der of  data  bits  DO  through  D7,  U65  and  U85  being  DO, 
through  U74  and  U92  being  D7  Note  in  Figure  2-15  that  the 
two  banks  are  different  with  jumper  options  in  the  lower 
bank,  these  options  are  for  the  possible  use  of  16k  three 
voltage  parts  When  jumpered  as  shown  in  Figure  2-14  the 
bank  is  identical  to  the  second  bank  and  is  for  using  64k 
DRAMs  With  both  banks  filled  there  is  1 28k  available  to  the 
user 

2.1.8  Video  Circuit 
Video  Modes 

The  Model  4  has  many  video  options  available  through 
hardware  and  software  Software  has  control  of  inverse 
video  on  a  character  by  character  basis  by  turning  on  IN- 
VIDE  Note  that  this  implies  the  available  number  of  charac- 
ters is  now  1 28  since  the  most  significant  bit  of  the  character 
code  in  memory  is  now  used  to  indicate  inverse  character 
Similarly,  an  alternate  character  set  can  be  enabled  by  turn- 
ing on  ENALTSET  This  enables  a  new  64  characters  in 
place  of  the  last  64  characters,  that  is,  the  Kana  set  in  place 
of  the  game  set  An  option  not  available  to  software  is  an 
enhanced  character,  which  moves  characters  down  one  row 
in  their  character  block  to  make  an  inverse  character  appear 
within  the  inverse  block  and  not  on  the  edge  of  the  block 
This  is  done  by  moving  jumper  JP1 1  to  JP1 2  As  an  exam- 
ple of  a  combination  of  hardware  and  software  opttons  avail- 
able in  the  video  is  the  overlay,  which  not  only  requires  the 
Graphics  Board  to  be  installed,  but  also  software  to  enable 
the  graphics  data  and  the  video  data  with  text  at  the  same 
time 


The  Model  4  also  has  an  option  for  either  64  character  or  80 
character  wide  screen  The  64  character  screen  is  compati- 
ble with  the  Model  III  and  displays  16  lines  The  80  charac- 
ter screen  displays  24  lines  In  addition  each  of  these  has  a 
double  width  mode  These  options  are  controlled  by  two  bits, 
MODSEL  and  8064  which  provide  the  screens  as  shown  in 
the  following  table 


8064 


MODSEL 


Video  Screen  Size 


0 
0 

1 

1 


0 

1 

0 

1 


64  x  16 
32  X  16 
80x24 
40x24 


Table  2-4 


With  this  information  of  the  options  available  to  the  user  we 
can  now  view  the  actual  operation  of  the  circuit  with  the  final 
objectives  in  mind  and  see  how  they  are  achieved  For  the 
rest  of  this  section  all  references  will  be  made  to  Figure  2- 
16  The  first  task  to  be  accomplished  would  be  the  screen 
refresh  and  ihis  is  done  by  the  CRTC  or  68045  (U11)  which 
will  generate  the  addresses  continuously  on  its  address 
lines  Then  to  allow  the  CPU  access  to  the  same  memory 
the  address  lines  are  multiplexed  at  U12,  U14,  and  U15  on 
opposite  phases  ol  the  CRT  clock  The  CPUs  access  timing 
is  ihen  handed  by  the  timing  circuit  described  earlier 

The  data  bus  of  the  RAM  (U16)  is  a  two  way  bus  with  the 
RAM  as  a  source  or  destination  on  all  accesses,  the  video 
gate  array  (U17)  is  the  destination  on  the  screen  refresh  half 
of  the  cycle,  the  74LS373  (U36)  is  the  destination  on  a  read 
of  the  RAM  by  the  CPU,  and  the  74LS244  (U35)  is  the 
source  on  wntes  to  the  RAM 

The  video  gate  array  then  gates  the  RAM  data  IN  VIDE,  and 
ENALTSET  to  determine  the  ROM  addressing  for  these  two 
options  and  CHRADD  to  the  74LS283  (U13)  which  takes  the 
row  address  from  the  68045  and  adds  a  zero  to  the  row  ad- 
dress or  a  minus  one  to  form  the  character  enhanced  mode 

The  data  out  of  the  ROM  is  then  sent  back  to  the  gate  array 
where  it  is  then  changed  to  a  serial  stream  of  data  which  is 
synchronized  with  the  data  that  would  come  from  the  graph- 
ics board,  GRAFVID  The  signal  CL166  will  inhibit  the  data 
out  of  the  serial  register  and  the  signal  ENGRAF  enables 
the  graphics  data,  hence,  if  both  are  enabled  the  effect  is  an 
overlay  The  output  data  is  sent  to  U20  pin  9  where  it  is 
gated  with  one  of  two  phases  of  the  dot  clock,  then  after 
being  filtered  to  lower  the  R  F  I  it  is  output  to  the  sweep 
board 
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Port 

D7 

FC-FF 

Cass 

(READ) 

data 

500  bd 

FC-FF 

(WRITE) 

X 

F8-FB 

Prntr 

(READ) 

BUSY 

F8-FB 

Prntr 

(WRITE) 

D7 

06 


Prntr 
Paper 

Prntr 
D6 


Model  4  Port  Bit  Map 
D6  04  03 

(MIRROR   of  PORT      EC) 
(Note,  also  resets  cassette  data  latch) 


D2 


Prntr 
Select 

Prntr 
D5 


Prntr 
Fault 

Prntr 
D4 


x 
x 

Prntr 
D3 


x 

X 

Prntr 
D2 


D1 


cass, 
out 

X 
X 

Prntr 
D1 


DO 

Cassette 

data 
1500bd 

cassette 

data  out 

x 

X 

Prntr 
DO 


EC-EF 


(Any  Read  causes  reset  of  Real  Time  Clock  Interrupt) 


EC-EF 

X 

CPU 

X 

Enable 

Enable 

Mode 

Cass 

X 

(WRITE) 

X 

Fast 

X 

EX  I/O 

Altset 

Select 

Mot  On 

X 

E0-E3 

X 

Receive 

Receive 

Xmit 

10  Bus 

RTC 

C  Fall 

C  Rise 

(READ) 

X 

Error 

Data 

Empty 

Int 

Int 

Int 

Int 

E0-E3 

X 

Enable 

Enable 

Enable 

Enable 

Enable 

Enable 

Enable 

(WRITE) 

X 

Rec  Err 

Rec  Data 

Xmit  Emp 

10  Int 

RTInt 

CF  Int 

CR  Int 

90-93 

X 

X 

X 

X 

X 

X 

X 

Sound 

(WRITE) 

X 

X 

X 

X 

X 

X 

X 

Bit 

84-87 

Page 

Fix  Upr 

Memory 

Memory 

Invert 

80/64 

Select 

Select 

(WRITE) 

Memory 

Bit  1 

BitO 

Video 

Bit  1 

BitO 

Table  2-3.  I/O  Port  Map 
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Figure  2-14.  ROM  Circuit 
(Page  1  of  Schematic) 


Hardware  38 


11 


ffiffls] 


i  ■*  ft  <J>    r-    <o 

'Til 


.&A 


"ifi   In   h 


h   h   h 


J 


t     (\J 

•r      ^ 
.  H       1 

*         lM 

*      ftj 

V         ^ 

*         CJ 

40- 

9- 

*  * 

*  Ifl  - 

4    Ul    rt 

3    *    ^ 
ID    It 

O 

*  5 
to  in  — 

did  v 
3  ^  * 

*     * 
IE   id    ^ 

3  "  a: 

*  * 

cO  to   ~ 

3   10    t 

*  2 

+    ID 

rt  <0  „ 

*  1 

<B  *>    - 
<n  ui  v 
=  <*>  tt 

w  1 

*  5 
_   in  — 

ai    ID  q 

*  2 

cj  in    z 

m  is  q 

=•    10    (t 

*  o 

. 

1a- 

* 
40 

3    «0 

* 
id  ^ 

ta  in 

* 

-  *> 

=     10 

* 
cu   *1 

(0 

* 

«■-   i« 

3    10 

(0 

* 

(0 

- 

n-    ;«flo,  WJ9 


3     ^ 
p       u 


O 

s 
< 

Q 


E 
<u 

j=. 
o 

01 

n      O 

T     « 
cm      „ 

a>     a> 

^      a 
3.    o- 


Hardware  39 


5    o 


o 

o 
a> 

•a 


ra 

E 
a> 

.c 
u 

(0 


CO        O 


G 


Hardware  40 


2.1.9  Keyboard 

The  interface  to  the  keyboard  is  a  matrix  composed  of  ad- 
dress lines  in  one  direction  and  data  lines  in  the  other.  The 
address  lines  have  two  open  collector  buffers  (U26  and  U40) 
on  the  output  to  the  keyboard. 

The  input  is  pulled-up  with  an  820  ohm  resistor  and  is  then 
fed  into  two  CMOS  Inputs  (U55  and  U56)  which  act  as  a 
driver  on  data  lines. 

2.1.10  Real  Time  Clock 

The  Real  Time  Clock  circuit  in  the  Model  4  provides  a  30  Hz 
(in  the  2  MHz  CPU  Mode)  or  60  Hz  (in  the  4  MHz  CPU 
Mode)  interrupt  to  the  CPU.  By  counting  the  number  of  inter- 
rupts that  have  occured,  the  CPU  can  keep  track  of  the 
time.  The  60  Hz  vertical  sync  signal  from  the  video  circuitry 
is  divided  by  two  (2  MHz  Mode)  by  U10  and  the  30  Hz  at 
pin  9  of  U46  is  used  to  generate  the  interrupts.  In  the  4  MHz 
mode,  the  signal  FAST  places  a  logic  low  at  pin  4  of  U10, 
causing  the  signal  VSYNC  to  pass  through  U46  at  its  normal 
rate  and  trigger  interrupts  at  the  60  Hz  rate.  Note  that  any 
time  interrupts  are  disabled,  the  accuracy  of  the  clock 
sutlers. 

2.1.11  Line  Printer  Port 

The  printer  status  tines  are  read  by  the  CPU  by  enabling 
buffer  U108.  This  buffer  will  be  enabled  for  any  input  from 
port  F8  or  F9,  or  any  memory  read  from  location  37E8  or 
37E9  when  in  the  Model  III  mode.  For  a  listing  of  bit  status, 
refer  to  the  bit  map. 

After  the  printer  driver  software  determines  that  the  printer  is 
ready  to  receive  a  character  (by  reading  the  status),  the 
character  to  be  printed  is  output  to  port  F8.  This  latches  the 
character  into  U107,  and  simultaneously  fires  the  one-shot 
U63  to  provide  the  appropriate  strobe  to  the  printer. 

2.1.12  Graphics  Port 

The  graphics  port  on  the  Model  4  is  provided  to  attach  the 
optional  high  resolution  graphics  board  and  provides  the 
necessary  signals  to  interface  not  only  to  the  CPU  (such  as 
data  lines,  address  lines,  address  decodes,  and  control 
lines),  but  also  the  signals  needed  to  synchronize  the  output 
of  the  Video  Circuit  and  the  Graphics  board  and  control  to 
provide  features  such  as  overlay. 


Pin  Number 

Signature 

1 

DO 

2 

D1 

3 

D2 

4 

D3 

5 

D4 

6 

OS 

7 

D6 

8 

D7 

9 

GEN* 

10 

DCLK 

11 

AO 

12 

A1 

13 

A2 

14 

J 

1S 

GRAPVID 

16 

ENGRAF 

17 

DISBEN 

16 

VSYNC 

19 

HSYNC 

20 

RESET* 

21 

WAIT* 

22 

H 

23 

1 

24 

IN" 

25 

GND 

26 

+  5 

27 

N/C 

26 

CL166 

29 

GND 

30 

+  5 

31 

GND 

32 

+  5 

33 

GND 

34 

+  5 

Table  2-5 
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Figure  2-1 7.  Keyboard 
(Page  4  of  Schematic) 
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Figure  2-18.  RTC 
(Page  4  of  Schematic) 
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2.1.13  Sound  Port 

The  sound  circuit  is  compatible  with  the  optional  sound 
board  on  the  older  version  of  the  Model  4  and  works  in  a 
similar  fashion  Sound  is  generated  by  setting  and  clearing 
data  bit  zero  on  successive  OUTs  to  port  90H  The  state  of 
DO  is  latched  in  U18  which  is  amplified  by  Q2  to  drive  the 
speaker  (SP1) 

2.1.14  I/O  Bus  Port 

The  Model  4  Gate  Array  Bus  is  designed  to  allow  easy  and 
convenient  interfacing  of  I/O  devices  to  the  Model  4  The  I/O 
Bus  supports  all  the  signals  necessary  to  implement  a  de- 
vice compatible  with  the  Z-80s  I/O  structure  That  is 

Addresses 

AO  to  A7  allow  selection  of  up  to  256  input  and  256  output 
devices  if  external  I/O  is  enabled 

Ports  80H  to  OFFH  are  reserved  lor  System  use 

Oata 

DBO  to  DB7  allow  transfer  of  8-bit  data  onto  the  pro- 
cessor data  bus  if  external  I/O  is  enabled 

Control  Lines 

a  IN'  —  2-80  signal  specifying  that  an  input  is  in 
progress  Gated  with  IORQ 

b  OUT*  —  Z-80  signal  specifying  that  an  output  is  in 
progress  Gated  with  IORQ 

c  RESET*  —  system  reset  signal 

d  IOBUSINT*  —  input  to  the  CPU  signaling  an  inter- 
rupt from  an  I/O  Bus  device  if  I/O  Bus  interrupts  are 
enabled 

e  IOBUSWAIT*  —  input  to  the  CPU  wait  line  allowing 
I/O  Bus  device  to  force  wart  states  on  the  Z-80  if 
external  I/O  is  enabled 

f  EXTIOSEL*  —  input  to  CPU  which  switches  the  I/O 
Bus  data  bus  transceiver  and  allows  an  INPUT  in- 
struction to  read  I/O  Bus  data 

g  M1*  —  and  IORQ*  —  standard  Z-80  signals 

The  address  fine,  data  line,  and  control  lines  a  to  c  and  e  to 
g  are  enabled  only  when  the  ENEXIO  bit  is  set  to  a  one 


To  enable  I/O  interrupts,  the  ENIOBUSINT  bit  in  the  CPU  IO- 
PORT  E0  (output  port)  must  be  a  one  However  even  if  it  is 
disabled  from  generating  interrupts  the  status  ot  the  IOBU- 
SINT* line  can  still  read  on  the  appropriate  bit  of  CPU  IO- 
PORT  E0  (input  port) 

See  Model  4  Port  Bit  assignment  for  OFF  OEC  and  0E0 

The  Model  4  CPU  board  is  fully  protected  from  foreign  I/O 
devices  in  that  all  the  I/O  bus  signals  are  buffered  and  can 
be  disabled  under  software  control  To  attach  and  use  an  I/O 
device  on  the  I/O  Bus,  certain  requirements  (both  hardware 
and  software)  must  be  met 

For  input  port  device  use,  you  must  enable  external  I/O  de- 
vices by  writing  to  port  OECH  with  bit  4  on  in  the  user  soft- 
ware This  will  enable  the  data  bus,  address  lines,  and 
control  signals  to  the  I/O  Bus  edge  connector  When  the  in- 
put device  is  selected,  the  hardware  will  acknowledge  by  as- 
serting EXTIOSEL*  low  This  switches  the  data  bus 
transceiver  and  allows  the  CPU  to  read  the  contents  of  the  1/ 
O  Bus  data  lines  See  Figure  2-21  for  the  timing  EXTIO- 
SEL" can  be  generated  by  NANDing  IN  and  the  I/O  port 
address 

Output  port  device  use  is  the  same  as  the  input  port  device 
in  use,  in  that  the  external  I/O  devices  must  be  enabled  by 
wnting  to  port  OECH  with  bit  4  on  in  the  user  software  —  in 
the  same  fashion 

For  either  input  or  output  devices,  the  IOBUSWAIT*  control 
line  can  be  used  in  the  normal  way  for  synchronizing  slow 
devices  to  the  CPU  Note  that  since  dynamic  memories  are 
used  in  the  Model  4,  the  wait  line  should  be  used  with  cau- 
tion Holding  the  CPU  in  a  wait  state  for  2  msec  or  more 
may  cause  loss  of  memory  contents  since  refresh  is  inhib- 
ited during  this  time  It  is  recommended  that  the  IOBUS- 
WAIT* line  be  held  active  no  more  than  500  msec  with  a 
25%  duty  cycle 

The  Model  4  will  support  Z-80  mode  1  interrupts  A  RAM 
lump  table  is  supported  by  the  LEVEL  II  BASIC  ROMs  and 
the  user  must  supply  the  address  of  his  interrupt  service 
routine  by  writing  this  address  to  locations  403E  and  403  F 
When  an  interrupt  occurs,  the  program  will  be  vectored  to 
the  user  supplied  address  if  I/O  Bus  interrupts  have  been 
enabled  To  enable  I/O  Bus  interrupts,  the  user  must  set  bit 
3  of  Port  0E0H 

The  actual  implementation  is  shown  in  Figure  2-22  The  data 
is  buffered  in  both  directions  using  a  74LS245  (U101)  The 
addresses  are  buffered  with  a  74LS244  (U102)  and  the 
control  lines  out  are  buffered  by  a  74LS367  Note  that  RE- 
SET* is  always  enabled  out,  this  is  to  power-up  reset  any 
device  or  clear  any  device  before  enabling  the  bus  structure 
This  prevents  any  user  from  tying-up  the  bus  when  enabling 
the  port  in  an  unknown  state 
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Data  Bit 

DO 
D1 
D2 
D3 
D4 

D5 


D6 
D7 


Function 

Selects  Drive  0  when  set* 
Selects  Drive  1  when  set* 
Selects  Drive  2  when  set* 
Selects  Drive  3  when  set* 
Selects  Side  0  when  reset 
Selects  Side  1  when  set 
Write  precompensation 
enabled  when  set  dis- 
abled when  reset 
Generates  WAIT  if  set 
Selects  MFM  mode  if  set 
Selects  FM  mode  if  reset 


'Only  one  of  these  bits  should  be  set  per  output 

Hex  D  flip-flop  U79  (74L174)  latches  the  drive  select  bits, 
side  select  and  FM*  MFM  bits  on  the  rising  edge  of  the  con- 
trol signal  DRVSEL*  Gate  Array  4  4(U76)  is  used  to  latch 
the  Wait  Enable  and  Write  precompensation  enable  bits  on 
the  rising  edge  of  DRVSEL"  The  rising  edge  of  DRVSEL* 
also  triggers  a  one-shot  (Internal  to  U76)  which  produces  a 
Motor  On  to  the  disk  drives  The  duration  of  the  Motor  On 
signal  is  approximately  three  seconds  The  spindle  motors 
are  not  designed  lor  continuous  operation  Therefore,  the  in- 
active state  of  the  Motor  On  signal  is  used  to  clear  the  Drive 
Select  Latch,  which  de-selects  any  drives  which  were  previ- 
ously selected  The  Motor  On  one-shot  is  retnggerable  by 
simply  executing  another  OUT  instruction  to  the  Dnve  Select 
Latch 

Wait  State  Generation  and  WAITIMOUT  Logic 

As  previously  mentioned,  a  wait  state  to  the  CPU  can  be  ini- 
tiated by  an  OUT  to  the  Drive  Select  Latch  with  D6  set  Pin 
10  of  U76  will  go  high  after  this  operation  This  signal  is  in- 
verted by  1/4  ot  U96  and  is  routed  to  the  CPU  where  it 
forces  the  Z80A  into  a  wait  state  The  Z80A  will  remain  in 
the  waif  state  as  long  as  WAIT*  is  low  Once  initiated,  the 
WAIT*  will  remain  low  until  one  of  five  conditions  is  satisfied 
If  INTRQ,  DRQ,  or  RESET  inputs  become  active  (logic 
high),  it  causes  WAIT"  to  go  high  which  allows  the  280  to 
exit  the  wait  state  An  internal  timer  on  U70  serves  as  a 
watchdog  timer  to  insure  that  a  wait  condition  will  not  persist 
long  enough  to  destroy  dynamic  RAM  contents  This  internal 
watchdog  timer  logic  will  limit  the  duration  of  a  wait  to  1024 
(jLsec,  even  if  the  FDC  chip  should  fail  to  generate  a  DRQ  or 
an  INTRQ 


Clock  Generation  Logic 

A  16  MHz  crystal  oscillator  and  Gate  Array  4  4  (U76)  are 
used  to  generate  the  clock  signals  required  by  the  FDC 
board  The  16  MHz  oscillator  is  implemented  internal  fo  U76 
and  a  quartz  crystal  (Y2)  The  output  of  the  oscillator  is  di- 
vided by  2  to  generate  on  8  MHz  clock  This  is  used  by  the 
FDC  1773  (U75)  for  all  internal  timing  and  data  separation 
U76  further  divides  the  16  MHz  clock  to  drive  the  watchdog 
timer  circuit 

Disk  Bus  Output  Drivers 

High  current  open  collector  drivers  U96,  94  and  93  are  used 
to  buffer  the  output  signals  from  the  FDC  circuit  to  the  disk 
drives 

Write  Precompensation  and 
Write  Data  Pulse  Shaping  Logic 

All  write  precompensation  is  generated  internal  to  the  FDC 
chip  1773  (U75)  Write  Precompensation  occurs  when  WG 
goes  high  and  write  precompensation  is  enabled  from  the 
software  ENP  is  multiplexed  with  RDY  and  is  controlled  by 
WG  at  pin  20  of  U75  Wnte  data  is  output  on  pin  22  of  U75 
and  is  shaped  by  a  one-shot  (1/2  of  U98)  which  stretches 
the  data  pulses  to  approximately  500  nsec 

Clock  and  Read  Data  Recovery  Logic 

The  Clock  and  Read  Data  Recovery  Logic  is  done  internal 
to  the  1773  (U75) 

Floppy  Disk  Controller  Chip 

The  1773  is  an  MOS  LSI  device  which  performs  the 
functions  of  a  floppy  disk  formatter/controller  in  a  sin- 
gle chip  implementation.  The  following  port  addresses 
are  assigned  to  the  internal  registers  ot  the  1773  FDC 
chip: 


wtNo. 

Function 

F0H 

Command/Status 

Register 

F1H 

Track  Register 

F2H 

Sector  Register 

F3H 

Data  Register 

If  an  OUT  to  Dnve  Select  Latch  is  initiated  with  D6  reset 
(logic  low),  a  WAIT  is  still  generated  The  infernal  timer  on 
U70  will  count  to  2  which  will  clear  the  WAIT  state  This  al- 
lows the  WAIT  to  occur  only  during  the  OUT  instruction  to 
prevent  violating  any  Dynamic  RAM  parameters 

NOTE   This  automatic  WAIT  will  cause  a   5  to  1  (i.sec  wait 
each  time  an  out  to  Drive  Select  Latch  is  performed 
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2.1.15  Cassette  Circuit 


Control  and  Data  Buffering 


The  cassette  write  circuitry  latches  the  two  LSBs  (DO  and 
D1)  for  any  output  to  port  FF  (hex)  The  outputs  of  these 
latches  (U51)  are  then  resistor  summed  to  provide  three  dis- 
crete voltage  levels  (500  Baud  only)  The  firmware  toggles 
the  bits  to  provide  an  output  signal  of  the  desired  frequency 
at  the  summing  node 

There  are  two  types  of  cassette  Read  circuits  —  500  baud 
and  1 500  baud  The  500  baud  circuit  is  compatible  with  both 
Model  I  and  HI  The  input  signal  is  amplified  and  filtered  by 
Op  amps  (U23  and  U54)  Part  of  U22  then  forms  a  Zero 
Crossing  Detector,  the  output  of  which  sets  the  latch  U37  A 
read  of  Port  FF  enables  buffer  U52  which  allows  the  CPU  to 
determine  whether  the  latch  has  been  set,  and  simultane- 
ously resets  the  latch  The  firmware  determines  by  the  tim- 
ing between  settings  of  the  latch  whether  a  logic  "one"  or 
'"zero"  was  read  in  from  the  tape 

The  1500  baud  cassette  read  circuit  is  compatible  with  the 
Model  III  cassette  system  The  incoming  signal  is  compared 
to  a  threshold  by  part  of  U22  U22's  output  will  then  be 
either  high  or  low  and  clock  about  one-half  of  U37,  depend- 
ing on  whether  it  is  a  nsing  edge  or  a  falling  edge  If  inter- 
rupts are  enabled,  the  setting  of  either  latch  will  generate  an 
interrupt  As  in  the  500  baud  circuit,  the  firmware  decodes 
the  interrupts  into  the  appropriate  data. 

For  any  cassette  read  or  write  operation,  the  cassette  relay 
must  be  closed  in  order  to  slart  the  motor  of  the  cassette 
deck  A  wnte  to  port  EC  hex  with  bit  one  set  will  latch  U53, 
which  turns  on  transistor  Q3  and  energizes  the  relay  K1  A 
subsequent  write  to  this  port  with  bit  one  clear  will  clear  the 
latch  and  de-energize  the  relay 

2.1.16  FDC  Circuit 

The  TRS-80  Model  4  Floppy  Disk  Interface  provides  a  stan- 
dard 5-1/4"  floppy  disk  controller  The  Floppy  Disk  Interface 
supports  single  and  double  density  encoding  schemes  Write 
precompensalion  can  be  software  enabled  or  disabled  be- 
ginning at  any  track,  although  the  system  software  enables 
write  precompensalion  for  all  tracks  greater  than  twenty-one 
The  amount  of  write  precompensation  is  125  nsec  and  is  not 
adjustable  One  to  four  drives  may  be  controlled  by  the  in- 
terface All  data  transfers  are  accomplished  by  CPU  data  re- 
quests In  double  density  operation,  data  transfers  are 
synchronized  to  the  CPU  by  forcing  a  wait  to  the  CPU  and 
clearing  the  wait  by  a  data  request  from  the  FDC  chip  The 
end  of  the  data  transfer  is  indicated  by  generation  of  a  non- 
maskable interrupt  from  the  interrupt  request  output  of  the 
FDC  chip  A  hardware  watchdog  timer  insures  that  any  error 
condition  will  not  hang  the  wait  line  to  the  CPU  for  a  period 
long  enough  to  destroy  RAM  contents 


The  Floppy  Controller  is  an  I/O  port-mapped  device  which 
utilizes  ports  E4H,  FOH,  F1H,  F2H,  F3H,  and  F4H  The  de- 
coding logic  is  implemented  in  the  Address  Decoding  (for 
more  information  see  Port  Map)  U78  is  a  bi-directional,  8-bit 
transceiver  used  to  buffer  data  to  and  from  the  FDC  and 
RS-232  circuits  The  direction  of  data  transfer  is  controlled 
by  the  combination  of  control  signals  D1SKIN",  RDINTSTA- 
TUS*,  RDNINSTATUS*.  and  RS232IN*  I*  any  signal  is  active 
(logic  low),  U78  is  enabled  to  drive  data  onto  the  CPU  data 
bus  If  all  signals  are  inactive  (logic  high),  U78  is  enabled  to 
receive  data  from  the  CPU  board  data  bus  A  second  buffer 
U77  is  used  to  buffer  the  FDC  chip  data  to  the  FDC/RS232 
Data  Bus,  (BD0-BD7)  U77  is  enabled  by  Chip  Select  and  its 
direction  controlled  by  DISKIN'  Again,  if  DISKIN*  is  active 
(logic  low),  data  is  enabled  to  drive  from  the  FDC  chip  to  the 
Main  Data  Busses  If  DISKIN*  is  inactive  (logic  high),  data  is 
enabled  to  be  transferred  to  the  FDC  chip 

Non-maskable  Interrupt  Logic 

Gate  Array  4  4  (U75)  is  used  to  latch  data  bits  D6  and  D7 
on  the  rising  edge  of  the  control  signal  WRNMIMASKREG* 
This  enables  the  conditions  which  will  generate  a  non-mask- 
able interrupt  to  the  CPU  The  NMI  interrupt  conditions 
which  are  programmed  by  doing  an  OUT  instruction  to  port 
E4H  with  the  appropriate  bits  set  If  data  bit  7  is  set,  an  FDC 
interrupt  is  enabled  to  generate  an  NMI  interrupt  If  data  bit 
7  ts  reset,  interrupt  requests  from  the  FDC  are  disabled  If 
data  bit  6  is  sel,  a  Motor  Time  Out  is  enabled  to  generate  an 
NMI  interrupt  If  data  bit  6  is  reset,  interrupts  on  Motor  Time 
Oul  are  disabled  An  IN  instruction  from  port  E4H  enables 
the  CPU  to  determine  the  course  of  the  non-maskable  inter- 
rupt Data  bit  7  indicates  the  status  of  FDC  interrupt  request 
(INTRQ)  (0  =  true,  1=  false)  Data  bit  6  indicates  the  status 
of  Motor  Time  Out  (0  =  true,  1  =  false)  Data  bit  5  indicates 
the  status  of  the  Reset  signal  (0=lrue,  1  =  false)  The  con- 
trol signal  RDNMISTATUS*  gates  this  status  onto  the  CPU 
data  bus  when  aciive  (logic  low) 

Drive  Select  Latch  and  Motor  ON  Logic 

Selecting  a  drive  prior  to  disk  I/O  operation  is  accomplished 
by  doing  an  OUT  instruction  to  port  F4H  with  the  proper  bit 
set  The  following  table  descnbes  the  bit  allocation  of  the 
Drive  Select  Latch 


G 
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2.1.17  RS-232C  Circuit 


RS-232C  Technical  Description 

The  RS-232C  circuit  for  the  Mode!  4  computer  supports 
asynchronous  senal  transmissions  and  conforms  to  the  EIA 
RS-232C  standards  at  the  input-output  interlace  connector 
(J3)  The  heart  of  the  circuit  is  the  TR1865  Asynchronous 
Receiver/Transmitter  U84  It  performs  the  job  of  converting 
the  parallel  byte  data  from  the  CPU  to  a  serial  data  stream 
including  start,  stop,  and  panty  bits  For  a  more  detailed  de- 
scription of  how  this  LSI  circuit  performs  these  functions,  re- 
fer to  the  TR1865  data  sheets  and  application  notes  The 
transmit  and  receive  clock  rates  that  the  TR1865  needs  are 
supplied  by  the  Baud  Rate  Generator  U104  This  circuit 
takes  the  5  0688  MHz  supplied  by  the  system  timing  circuit 
and  the  programmed  information  received  from  the  CPU 
over  the  data  bus  and  divides  the  basic  clock  rate  to  provide 
two  clocks  The  rates  available  from  the  BRG  go  from  50 
Baud  to  19200  Baud  See  the  BRG  table  for  the  complete 
list. 


Interrupts  are  supported  in  the  RS-232C  Circuit  by  the  Inter- 
rupt mask  register  and  the  Status  register  internal  to  Gate 
Array  4  5  (U82)  The  CPU  looks  here  to  see  which  kind  of 
interrupt  has  occurred  Interrupts  can  be  generated  on  re- 
ceiver data  register  full,  transmitter  register  empty,  and  any 
one  of  the  errors  —  panty,  framing,  or  data  overrun  This  al- 
lows a  minimum  of  CPU  overhead  in  transferring  data  to  or 
from  the  UART  The  interrupt  mask  register  is  port  EO  (write) 
and  the  interrupt  status  register  is  port  EO  (read)  Refer  to 
the  IO  Port  descnption  for  a  full  breakdown  of  all  interrupts 
and  their  bit  positions 

All  Model  I,  III,  and  4  software  written  for  the  RS-232C  inter- 
face is  compatible  with  the  Model  4  Gate  Array  RS-232C  cir- 
cuit, provided  the  software  does  not  use  the  sense  switches 
to  configure  the  interlace  The  programmer  can  get  around 
this  problem  by  directly  programming  the  BRG  and  UART  for 
the  desired  configuration  or  by  using  the  SETCOM  com- 
mand of  the  disk  operating  system  to  configure  the  interface 
The  TRS-80  RS-232C  Interface  hardware  manual  has  a 
good  discussion  of  the  RS-232C  standard  and  specific  pro- 
gramming examples  (Catalog  Number  26-1145) 


BRG  Programming  Table 


Nibble 
Loaded 

OH 
1H 
2H 
3H 
4H 
SH 
6H 
7H 
8H 
9H 
AH 
BH 
CH 
DH 
EH 
FH 


transmit/ 

Receive 

Baud 

Rate 

50 
75 

110 
134.5 

150 

300 

600 
1200 
1800 
2000 
2400 
3600 
4800 
7200 
9600 
19200 


16X 
Clock 

0.8  kHz 

1.2  kHz 

1 .76  kHz 

2  1523  kHz 

2.4  kHz 

4.8  kHz 

9.6  kHz 

19  2  kHz 

28.8  kHz 

32.081  kHz 

38.4  kHz 

57.6  kHz 

76.8  kHz 

115.2  kHz 

153.6  kHz 

307.2  kHz 


Pinout  Listing 


The  RS-232C  circuit  is  port  mapped  and  the  ports  used  are 
E8  to  E6  Following  is  a  descnption  of  each  port  on  both  in- 
put and  output. 


Output 

Master  Reset,  enables 
UART  control  register 
load 

UART  control  register 
load  and  modem  control 
Baud  rate  register  load 
enable  bit 

Transmitter  Holding 
register 


Port 

Input 

E8 

Modem  status 

EA 

UART  status 

E9 

Not  Used 

EB 

Receiver    Holding 

register 

The  following  list  is 
nector(P1) 

Pin  No. 

1 

2 

3 

4 

5 

6 

7 

0 

19 

20 

22 


Suported 

SETCOM 

Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 


a  pinout  description  of  the  DB-25  con- 
Signal 
PGND  (Protective  Ground) 
TD  (Transmit  Data) 
RD  (Receive  Data) 
RTS  (Request  to  Send) 
CTS  (Clear  To  Send) 
DSR  (Data  Set  Ready) 
SGND  (Signal  Ground) 
CD  (Carrier  Detect) 
SRTS  (Spare  Request  to  Send) 
DTR  (Data  Terminal  Ready) 
Rl  (Ring  Indicate) 
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Model  4  Gate  Array 
I/O  Pin  Assignments 


J1 


J2 


J3 


J4 


Pin 

Pin 

Pin 

Pin 

Pin 

No. 

Signal 

No. 

Signal 

No. 

Signal 

No. 

Signal 

No. 

Signal 

1. 

GND 

1. 

GND 

1. 

PGND 

1. 

XDO 

1. 

XDO 

2. 

2. 

2. 

TD 

2. 

GND 

2. 

GND 

3. 

GND 

3. 

GND 

3. 

RD 

3. 

XD1 

3. 

XD1 

4. 

4. 

4. 

RTS 

4. 

GND 

4. 

GND 

5. 

GND 

5. 

GND 

5. 

CTS 

5. 

XD2 

5. 

XD2 

6. 

6. 

6. 

DSR 

6. 

GND 

6. 

GND 

7. 

GND 

7. 

GND 

7. 

SGND 

7. 

XD3 

7. 

XD3 

8. 

IPE* 

8. 

IPI* 

8. 

CD 

8. 

GND 

8. 

GND 

9. 

GND 

9. 

GND 

9. 

9. 

XD4 

9. 

XD4 

10. 

DS2* 

10. 

DSO* 

10. 

10. 

GND 

10. 

GND 

11. 

GND 

11. 

GND 

11. 

11. 

XD5 

11. 

XD5 

12. 

DS3* 

12. 

DS1* 

12. 

12. 

GND 

12. 

GND 

13. 

GND 

13. 

GND 

13. 

13. 

XD6 

13. 

XD6 

14. 

14. 

14. 

14. 

GND 

14. 

GND 

15. 

GND 

15. 

GND 

15. 

15. 

XD7 

15. 

XD7 

16. 

MOTNE* 

16. 

MOTONI* 

16. 

16. 

GND 

16. 

GND 

17. 

GND 

17. 

GND 

17. 

17. 

XA0 

17. 

XA0 

18. 

DIRE* 

18. 

DIRI* 

18. 

18. 

GND 

18. 

GND 

19. 

GND 

19. 

GND 

19. 

SRTS 

19. 

XA1 

19. 

XA1 

20. 

STEPE* 

20. 

STEPI* 

20. 

DTR 

20. 

GND 

20. 

GND 

21. 

GND 

21. 

GND 

21. 

21. 

XA2 

21. 

XA2 

22. 

WDE* 

22. 

WDI* 

22. 

Rl 

22. 

GND 

22. 

GND 

23. 

GND 

23. 

GND 

23. 

23. 

XA3 

23. 

XA3 

24. 

WGE* 

24. 

WGI* 

24. 

24. 

GND 

24. 

GND 

25. 

GND 

25. 

GND 

25. 

25. 

XA4 

25. 

XA4 

26. 

TRKOE* 

26. 

TRKOI* 

26. 

26. 

GND 

26. 

GND 

27. 

GND 

27. 

GND 

27. 

27. 

XA5 

27. 

XA5 

28. 

WPRTE* 

28. 

WPRTI* 

28. 

28. 

GND 

28. 

GND 

29. 

GND 

29. 

GND 

29. 

29. 

XA6 

29. 

XA6 

30. 

RDE* 

30. 

RDI* 

30. 

30. 

GND 

30. 

GND 

31. 

GND 

31. 

GND 

31. 

31. 

XA7 

31. 

XA7 

32. 

SDSELE 

32. 

SDSELI 

32. 

32. 

GND 

32. 

GND 

33. 

GND 

33. 

GND 

33. 

33. 

XIN* 

33. 

XIN* 

34. 

34. 

34. 

34. 
35. 
36. 
37. 
38. 
39. 
40. 
41. 
42. 
43. 
44. 
45. 
46. 
47. 
48. 
49. 
50. 

GND 

XOUT* 

GND 

XRESET* 

GND 

XINT* 

GND 

XWAIT* 

GND 

EXTIO- 

SEL* 

GND 

NC 

GND 

XMt* 

GND 

XIDRQ* 

GND 

34. 
35. 
36. 
37. 
38. 
39. 
40. 
41. 
42. 
43. 
44. 
45. 
46. 
47. 
48. 
49. 
50. 

GND 
XOUT* 
GND 
XRESET' 
GND 
XINT* 
GND 
XWAIT* 
GND 
EXTIO- 
SEL* 
GND 
NC 
GND 
XMIO 
GND 
XIDRQ* 
GND 
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Model  4  Gate  Array 
I/O  Pin  Assignments 

J6 


J8 


J9 


J12 


Pin 

Pin 

Pin 

Pin 

No.  Signal 

No.  Signal 

No. 

Signal 

No. 

Signal 

1. 

1. 

1. 

1. 

DO 

2.  GND 

2. 

2. 

GND 

2. 

D1 

3.  PDO 

3. 

3. 

3. 

D2 

4.  GND 

4.  VSYNCO* 

4. 

CASSETTE- 

4. 

D3 

5.  PD1 

5. 

5. 

IN 

5. 

D4 

6.  GND 

6.  HSYNCO 

6. 

CASSETTE- 

6 

D5 

7.   PD2 

7. 

7. 

OUT 

7. 

D6 

8.  GND 

8. 

8. 

8. 

D7 

9.   PD3 

9. 

9. 

9. 

GEN* 

10.  GND 

10. 

10. 

10. 

DCLK 

11.   PD4 

11. 

11. 

11. 

AO 

12.  GND 

12. 

12. 

12. 

A1 

13.   PD5 

13. 

13. 

13. 

A2 

14.  GND 

14. 

14. 

14. 

J 

15.   PD6 

15. 

15. 

15. 

GRAPVID 

16.  GND 

16. 

16. 

16. 

ENGRAF 

17.   PD7 

17. 

17. 

17. 

DISBEN 

18.  GND 

18. 

18. 

18. 

VSYNC 

19.   N/A 

19. 

19. 

19. 

HSYNC 

20.  GND 

20. 

20. 

20. 

RESET* 

21.  BUSY 

21. 

21. 

21. 

WAIT* 

22.  GND 

22. 

22. 

22. 

H 

23.  OUT  PAPER 

23. 

23. 

23. 

t 

24.  GND 

24. 

24. 

24. 

IN* 

25.   UNITSEL 

25. 

GND 

26.   NC 

26. 

+  5V 

27.  GND 

27. 

28.   FAULT 

28. 

CL166 

29. 

29. 

GND 

30. 

30. 

+  5V 

31.  NC 

31. 

GND 

32. 

32. 

+  5V 

33.   NC 

33. 

GND 

34.  GND 

34. 

+  5V 

o 
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3.1  MODEL  4P  THEORY  OF  OPERATION 

3.1.1  Introduction 

Contained  in  the  following  paragraphs  is  a  description  of  the 
component  parts  of  the  Model  4P  CPU  It  is  divided  into  the  log- 
ical operational  functions  of  the  computer  All  components  are 
located  on  the  Main  CPU  board  inside  the  case  housing  Refer 
to  Section  3  for  disassembly  assembly  procedures 

3.1.2  Reset  Circuit 

The  Model  4P  reset  circuit  provides  the  neccessary  reset 
pulses  to  all  circuits  during  power  up  and  reset  operations  R25 
and  C21 8  provide  a  time  constant  which  holds  the  input  of  U 1 2 1 
low  during  power-up  This  allows  power  to  be  stable  to  all  cir- 
cuits before  the  RESET*  and  RESET  signals  are  applied  When 
C218  charges  to  a  logic  high  the  output  of  U121  triggers  the 
input  of  a  retnggerable  one-shot  multivibrator  (Ul)  U1  outputs 
a  pulse  with  an  approximate  width  of  70  microsecs  When  the 
reset  switch  is  pressed  on  the  front  pane!  this  discharges  C218 
and  holds  the  input  of  U1 21  low  until  the  switch  is  released  On 
release  o(  the  switch,  C218  again  charges  up  triggering  U121 
and  U1  to  reset  the  microcomputer 

3.1.3  CPU 

The  central  processing  unit  (CPU)  of  the  Model  4P  microcom- 
puter is  a  Z80A  microprocessor  The  Z80A  is  capable  of  run- 
ning in  either  2  MHz  or  4  MHz  mode  The  CPU  controls  all 
functions  of  the  microcomputer  through  use  of  its  address  lines 
(A0-A15),  data  lines  (D0-D7)  and  control  lines  (  M1  IOREQ 
RD.  WR.  MREQ,  and  RFSH)  The  address  lines  {A0-A1 5) 
are  buttered  to  other  ICs  through  two  74LS244s  (U68  and  U26) 
which  are  enabled  all  the  time  with  their  enables  pulled  to  GND 
The  control  lines  are  buffered  to  other  ICs  through  a  74F04 
(U86)  The  data  lines  (D0-D7)  are  buffered  through  a  bi-direc- 
tional 74LS245  (U71)  which  is  enabled  by  BUSEN*  and  the  di- 
rection is  controlled  by  BUSOIR' 

3.1.4  System  Timing 

The  main  timing  reference  of  the  microcomputer  with  the  ex- 
ception of  the  FDC  circuit,  comes  from  a  20  2752  MHz  Crystal 
Oscillator  (Y1)  This  reference  is  divided  and  used  for  gener- 
ating all  necessary  timing  tor  the  CPU  video  circuit  and  RS- 
232-C  circuit  The  output  of  the  crystal  oscillator  is  filtered  by  a 
ferntte  bead  (FB5)  470  ohm  resistor  (R46)  and  a  68  pf  ca- 
pacitor (C242)  After  being  filtered  it  is  led  into  U1 26  a  16R6A 
PAL  (Programmable  Array  Logic)  where  it  is  divided  by  2  to 
generate  a  10  1376  MHz  signal  (10M)  for  the  64  X  16  video  dis- 
play U126  divides  the  20  2752  MHz  by  4  to  generate  a  5  0688 
MHz  signal  (RS232CLK)  lor  the  baud  rate  generator  in  the  RS- 
232-C  circuit  The  CPU  clock  is  also  generated  by  U1 26  which 
can  be  either  2  or  4  MHz  depending  on  the  slate  of  FAST  input 


Ipin  9  of  U126)  tf  FAST  is  a  logic  low  the  20  2752  MHz  is  di- 
vided by  10  which  generates  a  2  2752  MHz  signal  If  FAST  is  a 
logic  high  the  20  2752  MHz  is  divided  by  5  which  generates  a 
4  05504  MHz  signal  The  CPU  clock  (PCLKI  is  fed  through  an 
active  pull-up  circuit  which  generates  a  full  5-volt  swing  with  last 
rise  and  fall  times  required  by  the  280A  U126  thel6R6APAL. 
generates  all  symmetrical  output  signals  and  also  does  no!  al- 
low the  PCIK  output  to  short  cycle  or  generate  a  low  or  high 
pulse  under  1 10  nanoseconds  which  the  Z80A  also  requires 
Reler  to  System  Timing  Fig.  3-2. 

3.1.4.1  Video  Timing 

The  video  timing  is  controlled  by  a  1 0L8  PAL  ( U 1 27)  and  a  four- 
bit  synchronous  counter  U128  (74LS161 )  These  two  ICs  gen- 
erate all  the  necessary  timing  signals  for  the  four  video  modes 
64  x  1 6  32  x  1 6,  80  x  24  and  40  x  24  Two  reference  clock  sig- 
nals are  required  for  the  four  video  modes  One  reference 
clock,  the  10  1376  MHz  signal  (10M)  is  generated  by  U1 26  and 
is  used  by  the  64  x  16  and  32  x  16  modes  The  second  refer- 
ence clock  is  a  12  672  MHz  (1 2M)  signal  which  is  generated  by 
a  Phase  Locked  Loop  (PLL)  circuit  and  is  used  by  the  80  x  24 
and  40  x  24  modes  The  PLL  circuit  consists  of  U1 47  (74LS93). 
U148  (NE564  PLL),  and  U149  (74LS90)  The  original  20  2752 
MHz  clock  is  divided  by  16  through  U147  which  generates  a 
1  2672  MHz  signal  The  output  of  U147  is  reduced  in  amplitude 
by  the  voltage  divider  network  R27  and  R28  and  the  output  is 
coupled  to  the  reference  input  of  U148  by  C227 

The  PLL  (NE564)  is  adjusted  to  oscillate  at  1 2  672  MHz  by  the 
tuning  capacitor  C231  This  12  672  MHz  clock  is  then  divided 
by  10  through  U149  to  generate  a  second  1  2672  MHz  signal 
which  is  fed  to  a  second  input  of  U148  The  two  1  2672  MHz 
signals  are  compared  internally  to  the  PLL  where  it  corrects  the 
12  672  MHz  output  so  it  is  synchronized  with  the  20  2752  MHz 
clock 

MODSEL  and  8064'  signals  are  used  to  select  the  desired 
video  mode  8064*  controls  which  reference  clock  is  used  by 
U127  and  MODSEL  controls  the  single  or  double  character 
width  mode  Refer  to  the  following  chart  for  selecting  each 
video  mode 


8064* 

MODSEL 

Video  Mode 

0 

0 

64  x  16 

0 

1 

32  x  16 

1 

0 

80x24 

1 

1 

40x24 

'This  is  the  state  to  be  written  to  latch  U89  Signal  is  inverted 
before  being  input  to  U127 
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DCLK,  ihe  reference  clock  selected,  is  output  from  U127. 
DCLK  is  fed  back  into  U127  for  internal  timing  reference  and 
is  also  fed  to  the  clock  input  of  U128  (74LS161).  U128  is 
configured  to  preload  with  a  count  of  9  each  time  it  reaches 
a  count  of  0.  This  generates  a  signal  output  of  TC  {128  pin 
1 5)  that  occurs  at  the  start  of  every  character  time  of  video 
oulput.  TC  is  used  to  generate  LOADS"  (Load  Shift  Regis- 
ter). QA  and  QC  of  U128  are  used  to  generate  SHIFT*, 
XADR7*,  CRTCLK  and  LOAD*  for  proper  timing  for  the  four 
video  modes.  QA,  QB,  and  QC  which  are  referred  to  as  H,  I, 
and  J  are  fed  1o  the  Graphics  Port  J7  for  reference  timings 
of  Hires  graphics  video.  Refer  to  Video  Timing,  Figs.  3-3  and 
3-4  for  timing  reference. 

3.1 .5  Address  Decode 

The  Address  Decode  section  will  be  divided  into  two  sub- 
sections: Memory  Map  decoding  and  Port  Map  decoding. 

3.1.5.1  Memory  Map  Decoding 

Memory  Map  Decoding  is  accomplished  by  a  16L8PAL(U109) 
Four  memory  map  modes  are  available  which  are  compatible 
with  the  Model  III  and  Model  4  microcomputers  A  second  16L8 
PAL  (U110)  is  used  in  conjunction  with  U109  for  Ihe  memory 
map  control  which  also  controls  page  mapping  of  the  32K  RAM 
pages.  Refer  to  Memory  Maps  below. 

3.1.5.2  Port  Map  Decoding 

Port  Map  Decoding  is  accomplished  by  three  74LS138S  (U87, 
U88,  and  U107).  These  ICs  decode  the  low  order  address  (A0- 
A7)  from  the  CPU  and  decode  the  port  being  selected  The  IN* 
signal  from  U108  enables  U87  which  allows  the  CPU  to  read 
from  a  selected  port  and  the  OUT*  signal,  also  from  U108,  en- 
ables U88  which  allows  the  CPU  to  write  to  the  selected  port 
U107  only  decodes  the  address  and  the  IN"  and  OUT*  signals 
are  ANDed  with  the  generated  signals. 

3.1.6  ROM 

The  Model  4P  contains  only  a  4K  x  8  Boot  ROM  (U70).  This 
ROM  is  used  only  to  boot  up  a  Disk  Operating  System  into 
the  RAM  memory.  If  Model  III  operation  or  DOS  is  required, 
then  the  RAM  from  location  0000-37FFH  must  be  loaded  with 
an  image  of  the  Model  III  or  4  ROM  code  and  then  executed. 
A  file  called  MODEL  A/Ill  is  supplied  with  the  Model  4P  which 
contains  the  ROM  image  for  proper  Model  III  operation.  On 
power-up,  the  Boot  ROM  is  selected  and  mapped  into  loca- 
tion 0000-OFFFH.  After  the  Boot  Sector  or  the  ROM  Image  is 
loaded,  the  Boot  ROM  must  be  mapped  out  by  OUTing  to 
port  9CH  with  DO  set  or  by  selecting  Memory  Map  modes  2 
or  3.  In  Mode  1  the  RAM  is  write  enabled  for  the  full  14K. 
This  allows  the  RAM  area  mapped  where  Boot  ROM  is  lo- 
cated to  be  written  to  while  executing  out  of  the  Boot  ROM. 
Refer  to  Memory  Maps. 


The  Model  4P  Boot  ROM  contains  all  the  code  necessary  to 
initialize  hardware  detect  options  selected  from  the  keyboard 
read  a  sector  from  a  hard  disk  or  floppy  and  load  a  copy  of  Ihe 
Model  III  ROM  Image  las  mentioned  I  mlo  the  lower  14K  of 
RAM 

The  firmware  is  divided  into  the  following  routines 

*  Hardware  Initialization 
"  Keyboard  Scanner 

*  Control 

*  Floppy  and  Hard  Disk  Driver 

*  Disk  Directory  Searcher 

*  File  Loader 

*  Error  Handler  and  Displayer 

*  RS-232  Boot 

*  Diagnostic  Package 

Theory  ol  Operation 

This  section  describes  the  operation  of  various  routines  in  the 
ROM  Normally,  the  ROM  is  not  addressable  by  normal  use 
However,  there  are  several  routines  that  are  available  through 
lixed  calling  locations  and  these  may  be  used  by  operating  sys- 
tems that  are  booting 

On  a  power-up  or  RESET  condition,  the  Z80  s  program  counter 
is  set  to  address  0  and  the  boot  ROM  is  switched-in  The  mem- 
ory map  of  the  system  is  set  to  Mode  0  (See  Memory  Map  for 
details  )  This  will  cause  the  Z80  to  letch  instructions  from  the 
boot  ROM 

The  Initialization  section  of  the  Boot  ROM  now  performs  these 
functions: 

1 .  Disables  maskable  and  non-maskable  interrupts 

2  Interrupt  mode  1  is  selected 

3  Programs  the  CRT  Controller 

4  Initializes  the  boot  ROM  control  areas  in  RAM 

5  Sets  up  a  stack  pointer 

6  Issues  a  Force  Interrupt  to  the  Floppy  Disk  Controller 
to  abort  any  current  activity 

7  Sets  the  system  clock  to  4mhz 

8  Sets  the  screen  to  64  x  1 6 

9  Disables  reverse  video  and  the  alternate  character 
sets 

10.  Tests  for  ■  key  being  pressed* 

1 1 .  Clears  all  2K  ol  video  memory 

"  This  is  a  special  test  If  the  •  is  being  pressed  then 

control  is  transferred  to  the  diagnostic  package  in  the 
ROM  All  other  keys  are  scanned  via  the  Keyboard 
Scanner 
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The  Keyboard  scanner  is  now  called  II  scans  the  keyboard  for 
a  set  period  of  time  and  returns  several  parameters  based  on 
which  if  any  keys  were  pressed 

The  keyboard  scanner  checks  for  several  different  groups  of 
keys  These  are  shown  below 


Function  Group 

Selection  Group 

F1 

A 

<F2> 

B 

<F3-> 

C 

<1> 

D 

<-2> 

E 

<3  > 

F 

-  Lelt-Shifl  • 

G 

-  Right-Shift  - 

-Ctrl  - 

'-Caps  - 

Special  Keys 

Misc  Keys 

<P^ 

Enter 

<L^ 

Break 

<N> 

When  any  key  in  the  Function  Group  is  pressed  it  is  recorded 
in  RAM  and  will  be  used  by  the  Control  routine  in  directing  the 
action  of  the  boot  It  more  than  one  of  these  keys  are  pressed 
during  the  keyboard  scan  the  last  one  detected  will  be  the  one 
that  is  used  The  Function  group  keys  are  currently  defined  as 


-  F1  -•  or  -  1  > 
^F2^  or  <-2~> 
<F3--or     3> 

•-  LeIt-Shift  - 
■-Right-Shift-- 
<Xlrl  - 
<-Caps  ■> 


Will  cause  hard  disk  boot 
Will  cause  floppy  disk  boot 
Will  force  Model  III  mode 
Reserved  for  future  use 
Boot  (rom  RS-232  port 
Reserved  for  future  use 
Reserved  for  future  use 


L  Instructs  the  Control  routine  to 

load  the  Model  III  ROM  image 
even  if  it  is  already  loaded  This 
is  useful  it  the  ROM  image  has 
been  corrupted  or  when  switch- 
ing ROM  images  (Note  that 
this  will  not  cause  the  ROM 
image  to  be  loaded  if  the  boot 
sector  check  indicates  that  the 
Model  ill  ROM  image  is  not 
needed  Press  F3  or  F3 
and     L     to  accomplish  that 

The  Selection  group  keys  are  used  in  determining  which  file  will 
be  read  from  disk  when  the  ROM  image  is  loaded  For  details 
of  this  operation  see  the  Disk  Directory  Searcher  If  more  than 
one  of  the  Selection  group  keys  are  pressed  the  last  one  de- 
tected will  be  the  one  that  is  used 


The  Miscellaneous  keys  are 


Break 


Enter 


Pressing  this  key  is  simply  re- 
corded by  setting  location 
405BH  non-zero  It  is  up  lo  an 
operating  system  to  use  this 
flag  if  desired 

Terminates  the  Keyboard  rou- 
tine Any  other  keys  pressed  up 
to  that  time  will  be  acted  upon 
Enter  is  uselui  for  experi- 
enced users  who  do  not  want  to 
wait  until  the  keyboard  timer 
expires 


The  Control  section  now  takes  over  and  follows  the  following 
flowchart 


The  Special  keys  are  commands  to  the  Control  routine  which 
direct  handling  of  the  Mode!  Ill  ROM-image  Each  key  is  de- 
tected individually 


<P, 


<N 


When  loading  the  Model  III 
ROM  image  the  user  will  be 
prompted  when  the  disks  can 
be  switched  or  when  ROM 
BASIC  can  be  entered  by 
pressing  Break 
Instructs  the  Control  routine  to 
not  load  the  Model  III  ROM 
image  even  if  i!  appears  that 
the  operating  system  being 
booted  requires  it 
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Begin 


®lioto    111 
(Hard   Disk    Boot 


Goto    [2] 


®(jOtO     i  ^  j 
(Floppy    Disk    Boot 


_,      Goto  [3J 

0  )     (Model  III  Boot] 


d> 


®Goto 
(RS-23 


[  4) 
2  Boot  > 


At  this  pointy  no  valid  function  keys 
^0  have  been  pressed. 
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Display 
"ROM    Image 
is    loaded" 
message 


Walt    for 
<ENTER>    or 
<BREAK>    to 
be   pressed 


3L. 


Write- protect 
memory  (Mode  0) 


I 


Set   CPU    speed 
to    2MHz 
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Switch  boot  ROM 
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Jump  to 
Transfer  Address 
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Vial*    for 
Sync    Byte 
FFH) 


Load   program 
from   BS-232 
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^ 


Display  and 
transmit  error 


^® 


Transfer 
control 
to  address 
received 


Packages  that  do  not  reference  the  Model  III  ROM  in  the 
boot  sector  can  still  cause  the  Model  III  ROM  image  to  be 
loaded  by  coding  a  CDxxOO  somewhere  in  the  boot  sector 
It  does  not  have  to  be  executable  At  the  same  time  Model 
4  packages  must  take  care  that  there  is  no  sequence  of 
bytes  in  the  boot  sector  that  could  be  mis  interpreted  to  be 
a  reference  to  the  Boot  ROM  An  example  of  this  would  be 
sequence  06CD0E00  which  is  a  LD  B  OCDH  and  a  LD 
C  0  If  the  boot  sector  cannot  be  changed  then  the  user 
must  press  the  F3  key  each  time  the  system  is  started 
to  inform  the  ROM  that  the  d  sk  contains  a  Model  111  pack 
age  which  needs  the  Mode1  III  ROM  image 

(2)  If  you  are  loading  a  Model  4  operating  system  then  the 
boot  ROM  will  always  transfer  control  to  the  first  byte  of  the 
boot  sector  which  is  at  4300H  tf  you  are  loading  a  Model 
lil  operating  system  or  about  to  use  Model  III  ROM  BASIC 
then  the  transfer  address  is  301 5H  This  is  the  address  of 
a  jump  vector  in  the   C   ROM  ol  the  Model  III  ROM  image 
and  this  will  cause  the  system  to  behave  exactly  like  a 
Model  III  If  the  ROM  image  file  that  is  loaded  has  a  differ 
ent  transfer  address  then  that  address  will  be  used  when 
loading  ts  complete  If  the  image  is  already  present  the 
Boot  ROM  will  use  301 5H 

(3)  Two  different  tests  are  done  to  insure  that  Ihe  Model  III 
ROM  image  is  present  The  first  test  is  to  check  every  third 
location  starting  at  3000H  for  a  C3H  This  is  done  for  10  lo 
cations  If  any  of  these  locations  does  not  contain  a  C3H 
then  the  ROM  image  is  considered  to  be    not  present 
The  next  test  is  to  check  two  bytes  at  location  OO0BH   If 
these  addresses  contain  E9E1H  then  the  ROM  image  is 
considered  to  be    present 


Notes 

( 1 )  If  the  boot  sector  was  not  256  bytes  in  length  then  it  is  as 
sumed  to  be  a  Model  lit  package  and  the  ROM  image  will 
be  needed  If  the  sector  is  256  bytes  m  length  then  the 
sector  is  scanned  for  the  sequence  CDxxOOH  The  CD  is 
the  lirst  byte  of  a  Z80  unconditional  subroutine  call  The 
next  byte  can  have  any  value  The  third  byte  is  tested 
against  a  zero  What  this  check  does  is  test  for  any  refer 
ences  to  the  first  256  bytes  of  memory  All  Radio  Shack 
Model  III  operating  systems  and  many  other  packages  all 
reference  the  ROM  at  some  point  during  the  boot  sector 
Most  boot  sectors  will  display  a  message  if  the  system  can 
not  be  loaded  To  save  space  these  routines  use  the 
Model  III  ROM  calls  to  display  the  message  Several  ROM 
calls  have  their  entry  points  in  the  first  256  bytes  of  mem 
ory  and  these  references  are  detected  by  the  boot  ROM 


(4)  See  Disk  Director  Searcher  for  more  information 

(5)  See  File  Loader  for  more  information 

(6)  The  RS  232  loader  is  described  under  RS  232  Boot 

Disk  Directory  Searcher 

When  the  Model  III  ROM  image  is  to  be  loaded  it  is  always  read 
from  the  floppy  in  drive  0 

Before  the  operation  begins  some  checks  are  made  First  the 
boot  sector  is  read  in  from  the  floppy  and  the  first  byte  is 
checked  to  make  sure  it  is  either  a  00H  or  a  FEH  If  the  byte 
contains  some  other  value  no  attempt  will  be  made  to  read  the 
ROM  image  from  that  disk  The  location  of  the  directory  cylinder 
is  then  taken  from  the  boot  sector  and  the  type  of  disk  is  deter 
mined  This  is  done  by  examining  the  Data  Address  Mark  that 
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was  picked  up  by  the  Floppy  Disk  Controller  (FDC)  during  the 
read  of  the  sector  If  the  DAM  equals  1   the  disk  is  a  TRSDOS 

1  x  style  disk  If  the  DAM  equals  0  then  the  disk  is  a  LDOS  5  1 
TRSDOS  6  style  disk  This  is  important  since  TRSDOS  1  x 
disks  number  sectors  starting  with  1  and  LDOS  style  disks 
number  sectors  starting  with  0 

Once  the  disk  type  has  been  determined  an  extra  test  is  made 
if  the  disk  is  a  LDOS  style  disk  This  test  reads  the  Granule  Al- 
location Table  (GAT)  to  determine  if  the  disk  is  single  sided  or 
double  sided 

The  directory  is  then  read  one  record  at  a  time  and  a  compare 
is  made  against  the  pattern  'MODEL%  for  the  filename  and 
'III'  for  the  extension  The  '%  means  that  any  character  will 
match  this  position  If  the  user  pressed  one  of  the  selection 
keys  (A-G)  during  the  keyboard  scan,  then  that  character  is 
substituted  in  place  of  the  '%  character  For  example,  it  you 
pressed  'D',  then  the  search  would  be  lor  the  file  MODELD  , 
with  the  extension  'III'  The  searching  algorithm  searches  until 
it  finds  the  entry  or  it  reaches  the  end  of  the  directory 

Once  the  entry  has  been  found,  the  extent  information  for  that 
file  is  copied  into  a  control  block  for  later  use 

File  Loader 

The  file  loader  is  actually  two  modules  —  the  actual  loader  and 
a  set  of  routines  to  fetch  bytes  from  the  file  on  disk  The  loader 
is  invoked  via  a  RST  28H  The  byte  fetcher  is  called  by  the 
loader  using  RST  20H  Since  restart  vectors  can  be  re-directed, 
the  same  loader  is  used  by  the  RS-232  boot  The  difference  is 
that  the  RST  20H  is  redirected  to  point  to  the  RS-232  data  re- 
ceiving routine  The  loader  reads  standard  loader  records  and 
acts  upon  two  types 

01  Data  Load 

1  byte  with  length  of  block,  including  address 

1  word  with  address  to  load  the  data 

n  bytes  of  data,  where  n  +  2  equals  the  length  specified 

02  Transfer  Address 

1  byte  with  the  value  of  02 

1  word  with  the  address  to  start  execution  at 

Any  other  loader  code  is  treated  as  a  comment  block  and  is  ig- 
nored Once  an  02  record  has  been  found,  the  loader  stops 
reading,  even  if  there  is  additional  data,  so  be  sure  to  place  the 

02  record  at  the  end  of  the  file 


Floppy  and  Hard  Disk  Driver 

The  disk  drivers  are  entered  via  RST  8H  and  will  read  a  sector 
anywhere  on  a  floppy  disk  and  anywhere  on  head  1  (top-head) 
in  a  hard  disk  drive  Either  256  or  512  byte  sectors  are  readable 
by  these  routines  and  they  make  the  determination  of  the  sector 
size  The  hard  disk  driver  is  compatible  with  both  the  WD1O00 
and  the  WD1010  controllers  The  floppy  disk  driver  is  written  for 
the  WD1 793  controller 

Serial  Loader 

Invoking  the  serial  loader  is  similar  to  forcing  a  boot  from  hard 
disk  or  lloppy  In  this  case  the  right  shilt  key  must  be  pressed  al 
some  time  during  the  first  three  seconds  after  reset  The  pro- 
gram does  not  care  if  the  key  is  pressed  forever  making  it  con- 
venient to  connect  pins  8  and  1 0  of  the  keyboard  connector  with 
a  shorting  plug  lor  bench  testing  of  boards  This  assumes  that 
the  ob|ect  program  being  loaded  does  not  care  about  the  key 
closure 

Upon  entry,  the  program  first  asserts  DTR  (J4  pin  20)  and  RTS 
(J4  pin  4)  true  Next,  Not  Ready  is  printed  on  the  topmost  line 
of  the  video  display  Modem  status  line  CD  <J4  pin  8)  is  then 
sampled  The  program  loops  until  it  finds  CD  asserted  true  At 
that  time  the  message  "Ready"  is  displayed  Then  the  program 
sets  about  determining  the  baud  rate  from  the  host  computer 

To  determine  the  baud  rate,  the  program  compares  data  re- 
ceived by  the  UART  to  a  test  byte  equal  to  55  hex  The  receiver 
is  first  set  to  1 9200  baud  If  ten  bytes  are  received  which  are  not 
equal  to  the  test  byte  the  baud  rate  is  reduced  This  sequence 
is  repeated  until  a  valid  test  byte  is  received  If  ten  failures  occur 
at  50  baud,  the  entire  process  begins  again  at  19200  baud  II  a 
valid  test  byte  is  received,  the  program  waits  for  ten  more  to  ar- 
rive before  concluding  that  it  has  determined  the  correct  baud 
rate  If  at  this  time  an  improper  byte  is  received  or  a  receiver  er- 
ror (overrun,  framing,  or  parity)  is  intercepted,  the  task  begins 
again  at  1 9200  baud 

In  order  to  get  to  this  point  the  host  or  the  modem  must  assert 
CD  true  The  host  must  transmit  a  sequence  of  test  bytes  equal 
to  55  hex  with  8  data  bits  odd  parity  and  1  or  2  stop  bits  The 
test  bytes  should  be  separated  by  approximately  0  1  second  to 
avoid  overrun  errors 

When  the  program  has  determined  the  baud  rate,  the  message 

"Found  Baud  Rate  x" 


• 


o 


is  displayed  on  the  screen  where  '  x"  is  a  letter  from  A  to  P 
meaning 

A  =  50  baud  E  =  150  I  =  1800  M  -  4800 

B  =  75  F  =  300  J  =  2000  N  -  7200 

C  =  110  G  =  600  K  =  2400  O  =  9600 

D=134  5  H  =  1200  L  -  3600  P  =  19200 


w 


Hardware  68 


The  same  message  less  the  character  signifying  the  baud  rale 
is  transmitted  to  the  host,  with  the  same  baud  rate  and  protocol 
This  message  is  the  signal  to  the  host  to  stop  transmitting  test 
bytes 

After  the  program  has  transmitted  the  baud  rate  message  it 
reads  from  the  UART  data  register  in  order  to  clear  any  overrun 
error  that  may  have  occurred  due  to  the  test  bytes  coming  in 
during  the  transmission  of  the  message  This  is  because  the  re- 
ceiver must  be  made  ready  to  receive  a  sync  byte  signalling  the 
beginning  of  the  command  file  For  this  reason  it  is  important 
that  the  host  wait  until  the  entire  baud  rate  message  (16  char- 
acters) is  received  before  transmitting  the  sync  byte  which  is 
equal  to  FF  hex 

When  the  loader  receives  the  sync  byte  the  message 

"Loading" 

is  displayed  on  the  screen  Again,  the  same  message  is  trans- 
mitted to  the  host,  and,  again  the  host  must  wait  for  the  entire 
transmission  belore  starting  into  the  command  file 

If  the  receiver  should  intercept  a  receive  error  while  waiting  for 
the  sync  byte,  the  entire  operation  up  to  this  poim  is  aborted 
The  video  display  is  cleared  and  the  message 


(Since  the  file  represents  Z80  machine  code  and  all  256 
combinations  are  meaningful  it  would  be  disastrous  to 
transmit  nulls  or  other  ASCII  control  codes  as  fillers  ac- 
knowledgement or  start-stop  bytes  The  only  control 
codes  needed  are  the  standard  command  file  control 
bytes ) 

Data  can  be  transmitted  to  the  loader  at  1 9200  baud  with  no  de- 
lays inserted  Two  stop  bits  are  recommended  at  high  baud 
rates 

See  the  File  Loader  description  for  more  information  on  file 
loading 

If  a  receive  error  should  occur  during  Me  loading  the  abort  pro- 
cedure described  above  will  take  place,  so  when  attempting  re- 
mote control,  it  is  wise  to  monitor  the  host  receiver  during 
transmission  of  the  file  When  the  host  is  near  the  object  board 
as  is  the  case  in  the  factory  application  or  when  more  than  one 
board  is  being  loaded,  it  may  be  advantageous  or  even  nec- 
essary to  ignore  the  transmitted  responses  of  the  objed 
board(s)  and  to  manually  pace  the  test  byte,  sync  byte  and 
command  file  phases  of  the  transmission  process  using  the 
video  display  for  handshaking 

System  Programmers  Information 


"Error,  x' 

is  displayed  near  the  bottom  of  the  screen,  where   x   is  a  letter 
from  B  to  H,  meaning 

B  =  parity  error 

C  =  framing  error 

D  =  parity  &  framing  errors 

E  =  overrun  error 

F  =  parity  &  overrun  errors 

G  =  framing  &  overrun  errors 

H  =  parity  &  framing  &  overrun  errors 

The  message 


The  Model  4P  Boot  ROM  uses  two  areas  of  RAM  while  it  is  run- 
ning These  are  4000H  to  40FFH  and  4300H  to  43FFH  (For 
512  byte  boot  sectors,  the  second  area  is  4300H  to  44FFH  )  If 
the  Model  III  ROM  Image  is  loaded  additional  areas  are  used 
See  the  technical  reference  manual  for  the  system  you  are  us- 
ing for  a  list  of  these  areas 

Operating  systems  that  want  to  support  a  software  restart  by  re- 
executing  the  contents  of  the  boot  ROM  can  accomplish  this  in 
one  of  two  ways  If  the  operating  system  relies  on  the  Model  111 
ROM  Image,  then  jump  to  location  0  as  you  have  in  the  past  If 
the  operating  system  is  a  Model  4  mode  package,  a  simple  way 
is  to  code  the  following  instructions  in  your  assembly  and  load 
them  before  you  want  to  reset 


"Error" 

is  then  transmitted  to  the  host  The  entire  process  is  then  re- 
peated from  the  '  Not  Ready'  message  A  six  second  delay  is 
inserted  before  reinitialization  This  is  longer  than  the  time  re- 
quired to  transmit  five  bytes  at  50  baud,  so  there  is  no  need  to 
be  extra  careful  here 

If  the  sync  byte  is  received  without  error,  then  the  "Loading' 
message  is  transmitted  and  the  program  is  ready  to  receive  the 
command  file  After  receiving  the  "  Loading  message  the  host 
can  transmit  the  file  without  nulls  or  delays  between  bytes 


Absolute  Location 

0000 
0001 
0003 


Instruction 

Dl 

LD  A1 

OUT  (9CH)  A 


These  instructions  cause  the  boot  ROM  to  become  address- 
able After  executing  the  OUT  instruction  the  next  instruction 
executed  will  be  one  in  the  boot  ROM  (These  instructions  also 
exist  in  the  Model  III  ROM  image  at  location  0  )  The  boot  ROM 
has  been  written  so  that  the  first  instruction  is  at  address  0005 
The  hardware  must  be  in  memory  mode  0  or  1 ,  or  else  the 
boot  ROM  will  not  be  switched  in  This  operation  can  be 
done  with  an  OUT  instruction  and  then  a  RST  0  can  be  exe- 
cuted to  have  the  ROM  switched  in 
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Restarts  can  be  redirected  at  any  time  while  the  ROM  is 
switched  m  All  restarts  jump  to  fixed  locations  in  RAM  and 
these  areas  may  be  changed  to  point  to  the  routine  that  is  to  be 
executed 

Restart    RAM  Location     Default  Use 

Cold  Start  Boot 

Disk  I  O  Request 

Display  string 

Display  block 

Byte  Fetch  (Called  by  Loader) 

File  Loader 

Keyboard  scanner 

Reserved  for  future  use 

NMI  (Floppy  I  O  Command 

Complete) 

The  above  routines  have  fixed  entry  parameters  These  are  de- 
scribed here 

Disk  I/O  Request  (RST  8H) 


Display  String  (RST1  OH) 


0 

none 

8 

4000H 

10 

4003H 

18 

4006H 

20 

4009H 

28 

400CH 

30 

400FH 

38 

401 2H 

66 

4015H 

Accepts 
A 

6 


DE 
HL 


Returns 
Z 
NZ 

Error  Codes 
3 
4 
5 
6 
7 

8 

9 

11 

12 


1  for  floppy  2  for  hard  disk 
Command 
Initialize        1 
Restore        4 
Seek  6 

Read  12  (All  reads  have  an  im- 

plied seek) 
Sector  number  to  read 
The  contents  of  the  location  disktype 
(40SCH)  are  added  to  this  value  before 
an  actual  read  If  the  disk  is  a  two  sided 
lloppy  just  add  18  to  the  sector  number 
Cylinder  number    (Only  E  is  used  in 
floppy  operations) 

Address  where  data  from  a  read  opera- 
tion is  to  be  stored 


Success  Operation  Completed 
Error  Error  code  in  A 


Hard  Disk  drive  is  not  ready 

Floppy  disk  drive  is  not  ready 

Hard  Disk  drive  is  not  available 

Floppy  disk  drive  is  not  available 

Drive  Not  Ready  and  no  Index  (Disk  in 

drive  door  open) 

CRC  Error 

Seek  Error 

Lost  Data 

ID  Not  Found 


Accepts 
HL 

DE 


Returns 
Success  Always 

A 

DE 

HL 


Pointer  to  text  to  be  displayed 
Text  must  be  terminated  with  a  null  (0) 
Offset  position  on  screen  where  text  is  to 
be  displayed 

(A  O000H  will  be  the  upper  left-hand  cor- 
ner of  the  display ) 


Altered 

Points  to  next  position  on  video 

Points  to  the  null  (0) 


Display  Block  (RST  18H) 


Accepts 
HL 


Points  to  control  vector  in  the  format 

+  0        Screen  Offset 

+  2        Pointer  to  text,  terminated  with 

null 

+  4        Pointer  to  text   terminated  with 

null 


+  n        word  FFFFH        End  of  control 
vector 
or  +n        word  FFFEH         Next  word  is 

new  Screen 
Offset 
If  Z  flag  is  set  on  entry,  (hen  the  first  screen  offset  is  read  from 
DE  instead  of  from  the  control  vector 

Each  siring  is  positioned  after  the  previous  string  unless  a 
FFFEH  entry  is  found  This  is  used  heavily  in  the  ROM  to  re- 
duce duplication  of  words  in  error  messages 

Returns 
Success  Always 

DE  Points  to  next  position  on  video 

Byte  Fetch  (RST  20H) 


Accepts  None 
Returns 

Z 

NZ 


G 


Errors 


2 

10 


Success  byte  tn  A 
Failure  error  code  in  A 


Any  errors  from  the  disk  I  O  call  and 

ROM  Image  can  t  be  loaded  —  Too  many 

extents 

ROM  Image  can  t  be  loaded  —  Disk  drive 

is  not  ready 
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File  Loader  (RST  28H) 

Accepts  None 


Returns 
Z 
NZ 

Errors 


Success 

Failure,  error  code  in  A 


Any  errors  from  the  disk  I/O  call  or  the 
byte  letch  call  and: 
0  The  ROM  image  was  not  found  on  drive  0 

There  are  several  pieces  ol  information  left  in  memory  by  the 
boot  ROM  which  are  useful  to  system  programmers.  These  are 
shown  below: 

RAM  Location         Description 

401  DH  ROM  Image  Selecled  (%  for  none 

selected  or  A-G) 
4055H  Boot  type 

1  ^  Floppy 

2  -  Hara  disk 

3  =  ARCNET 

4  -  RS-232C 

5  -  7  =  Reserved 

4056H  Boot  Sector  Size  (1  lor  256,  2  for  512) 

4057H  RS-232  Baud  Rate  (only  valid  on  RS- 

232  boot) 
4059H  Function  Key  Selected 

0  -  No  function  key  selected 


<F1>or<1  -- 

86 

<F2,or--2- 

87 

<F3     or:3- 

88 

<Caps - 

85 

<Ctrl^ 

84 

<Left-Shift> 

82 

■■  Right-Shift  • 

83 

Reserved 

80-81  and  89-90 

405BH 

Break  Key  Indication  (non-zero  if 

-  Break  -  pressed) 

405CH 

Disk  type 

(0  lor  LDOS 
TRSDOS6.1  for 
TRSDOS1.X) 

Keep  in  mind  that  Model  III  ROM  image  will  initialize  these 
areas,  so  this  information  is  useful  only  to  the  Model  4  mode 
programmer. 

3.1.7  RAM 

Two  configurations  of  Random  Access  Memory  (RAM)  are 
available  on  the  Model  4P:  64K  and  128K.  The  64K  and  128K 
option  use  the  6665-type  64K  x  1  200NS  Dynamic  RAM.  which 
requires  only  a  single  -  5v  supply  voltage. 


The  DRAMs  require  multiplexed  incoming  address  lines.  This 
is  accomplished  by  ICs  U 1 1 1  and  U 1 1 2  which  are  74LS1 57 
multiplexers.  Data  to  and  from  the  DRAMs  are  buffered  by  a 
74LS245  (U117)  which  is  controlled  by  Page  Map  PAL.  U110. 
The  proper  timing  signals  RASO".  RASr.  MUX*,  and  CAS"  are 
generated  by  a  delay  line  circuit  U97.  U1 15  (1  2  of  a  74S1 12) 
and  U1 16  (1  4  of  a  74F08)  are  used  the  generate  a  precharge 
circuit.  During  M1  cycles  of  the  Z80A  in  4  MHz  mode,  the  high 
time  in  MREQ  has  a  minimum  time  of  1 10  nanosecs.  The  spec- 
ification of  6665  DRAM  requires  a  minimum  of  1 20  nanosecs  so 
this  circuit  will  shorten  the  MREQ  signal  during  the  M1  cycle. 
The  resulting  signal  PMREQ  is  used  to  start  a  RAM  memory 
cycle  through  U1 13  (a  74S64).  Each  different  cycle  is  controlled 
at  U113  to  maintain  a  fast  M1  cycle  so  no  wait  stales  are  re- 
quired. The  output  ol  U113  (PRAS*)  is  ANDed  with  RFSH  to  not 
allow  MUX"  and  CAS-  to  be  generated  during  a  REFRESH 
cycle.  PRAS'  also  generates  either  RASO*  or  RAST.  depend- 
ing on  which  bank  of  RAM  the  CPU  is  selecting.  GCAS*  gen- 
erated by  the  delay  line  U97  is  latched  by  U1 15  (1  2  ol  a 
74S1 12)  and  held  to  the  end  of  the  memory  cycle.  The  output 
of  U1 15  is  ANDed  with  VIDEO  signal  to  disable  the  CAS*  signal 
from  occurring  if  the  cycle  is  a  video  memory  access.  Refer  to 
M1  Cycle  Timing  (Figure  3-8.  and  3-9.),  Memory  Read  and 
Memory  Write  Cycle  Timing  (Figure  3-10.)  and  (Figure  3- 
11.). 


Hardware  71 


3 

1               5S 

OS                i 

1               < 

'                         )SC 

*y>               1 

1                ^ 

1               f> 

i 

Z 
H 


W 

Q 
O 
S 


H 
CM 


Q  K 


> 


>  >  > 


ii  ii 


>H 

J 

M 

« 

K 

«  2 

.H 

.H 

«            1 

■**  o 

V£>           . 

•H 

Q 

u 

■-I 

a 

(0 

w 

•              X 

1               s 

s  < 

W 

Q 

M 

S           1 

a;  a; 

« 

> 

a;       1 

■J  J  S 

w  w  o 
co  en  a; 


o 

E 


■A 

■ 

CO 

9> 


o 


O) 


D 

i 


w 
> 

w 


Eh 

<: 

E-" 

en 


>  >  > 


w 

■* 

w 

w 

X  2 

iH 

r-t 

^ 

1            ** 

s 

<s*.  O 

W>            1 

l            f* 

o 

as 

.-( 

o 

o 

1-1 

1            *** 

Q 

m 

w 

'            _ 

Eh 
O 

o 

Q 

M 

51           ' 

'            » 

OS  OS 

« 

> 

as       j 

« 

03 

'a.sj.^H 


It    ll 
ii 

Si   rH 

J    J   S 

WBO 
tf)    Cfi  OS 


Hardware  72 


9 


1 

% 

1 

1 

Ptf 

1 

MS 

(M 

i 

1 

CM 

ea 

I 


w 

En 

2 

W 


co  en 
w  u 

Q   K 


1 

S6 

rH 

rH 

US 

I 

« 

"<sr 

VO 

1 

CM 

<-\ 

Q 

O 

.H 

<*> 

m 

w 

S 

>l 

n 

s 

1 

15 

<! 

w 

M 

<: 

5 

a; 

« 

> 

as 

0! 

1 

►n 

w 

>  >  > 

> 

m  *s,*s. 

w 

J 

w 

H 

< 

i— 1  <K.  i-i 

Eh 

M 

II 

II 

II 

St  r-l 

l-H 

J 

s 

W 

w 

o 

w 

W 

as 

o 
E 


a 
o 

s 


a.  < 

«  o 
o  a: 
—  w 


*~\ 


(D 
CO 

c 


w 
> 


>  >  > 

in  st  in 


s>s 

1 

K 

■^ 

1 

E 

i-l 

! 

O 

N5    O 

Q 

o 

<-\ 

1 

CO 

T 

CQ 

w 

1 

1 

^, 

en 
o 
o 

rH     W 

Eh 

E  n 
<  PS 

Q 
M 
> 

< 

a 

CQ 

K  S 

t 

i 

M 
Eh 

eft 


II    II 
II 

15.  rH 

J  J  E 
cq  h  o 

in  co  a; 


Hardware  73 


> 

W 


M 

s 

CO 


>  > 
if)  tfi 


HdX 


w  u 
a  os 


M 

i 


en 


w  y 


II     I! 


II 


1 

1 
1 
1 

<•> 

as 

OS 

1 

J  J  s 
WHO 
W  W  OS 


1 


i 

S 


O 


1 

< 

1 

% 

as 

| 

os 

1 

w 
> 


>  > 

la  in 


« 


n   it 


ii 


1 

« 

1 

s*s 

« 

« 

CM 

I 

H 

tN 

o 

1 

< 

os 

CO 

M 
Q 

os 

1 

w 

H 
> 

I 

•J  J  s 
W  W  O 


Q 


Hardware  74 


u 


En 


«     %     * 

-  <J  t 


En 


X 


r  e 

if 


/< 


"  E 


En 


^ 


r-^ 


u 


<N 


J 


L 


5 

CO 

c 
o 
o 


N 

X 
S 

o> 


o 

>. 
O 


CO 

m 

0) 

i_ 

3 
O) 


ir> 

.H 

Oi 

rH 

s 

Cd 

< 
I 

< 

Q 

X 

a 

a 

en 

w 

t- 

a 

a; 

S 

z  * 

W  CO 

Q  < 

os  a 

< 

OS 


u 

>-i 

* 

■K 

r-~ 

r-- 

0 

o 

X 

co 

«C 

Q 

p 

< 

OS 

£ 

*  * 

*  * 

t; 

u 

a 

I 

IS.  ■-( 

O.  <-4 

i 

>h, 

z  z 

CO   CO 

«>. 

C} 

H  U 

<  $ 

< 

s 

CO  CO 

«  « 

OS 

<  <* 

o 

a  os 

Hardware  75 


Eh 


CO 

E-i 


CM 


n 


J 


a 


5 
« 

c 
o 
in 

N 


2, 


o 

>. 
O 


to 
£ 

3 


C 


t>S       in 

•J  M 

&<       i 
is. 

< 


x 


m 

O 

as 

o 

z  * 

H 

a. 

to 

w 

W  CO 

ir. 

b 

a: 

O  < 

2 

OS 

s 

n 

M 

* 

* 

r- 

r- 

o 

O 

x: 

CO 

< 

Q 

o 

< 

a 

£ 

*  * 

*  * 

s 

a 

i 

I 

Z  3 

CO  CO 

o. 

H  W 

<   < 

eC 

£ 

to  en 

a  a 

K 

<  <; 

O 

ps  a 

Hardware  76 


i 


j 


CM 


n 


J 


9 


i 


in 


a 
a 


% 


n 

o 

s 

* 

u        u 

* 

■K 

r- 

r- 

qs 

Ed 

w 

to 

o        o 

X 

Ul 

< 

Q 

OS 

Q 

< 

D 

«C 

oz 

s 

£ 

os 

■K   *   *   * 

£ 

u 

Q 

1 

CM 

a; 

cm 

2  z  en  «j 

H  w  ri;  < 

CO  CO  PS  OS 
OS  OS 

1 

Si 

< 
os 
a 

<S. 

Hardware  77 


J 


CO 


CM 

E-i 


n 


u 


L 


Q 

a 


o 

u 


< 

Eh 

a 

M 
En 

M 

OS 
3 


a 
a 

< 

3 

O 

OS 


in 


01      -. 
w        as 

os       3 


a 

05 


w 

3 

OS 


* 

CO 

< 

OS 

Oj 


o 

*  -K 

z  z 

H  W 

CO  CO 

<  < 

os  as 


u 
o 

*     * 
IS,   rH 

01  CO 
<  < 
os  os 


* 

CO 


D 

s 

I 

si 


O) 

c 


a; 

u 

>« 
o 


5 

o 
E 

0) 


CO 

k. 
3 

O) 

u. 


O 


« 


Hardware  78 


Memory  Map  —  Mode!  4P 


ModeO 

SELO 
SEL1 
ROM 

o   -  OV 

0  OV 

1  OV 

Mode  1 

SELO    -  1    -   -5V 
SEL1    -  0    -  OV 
ROM    -  0         -5V 

0000  —  OFFF 

Boot  ROM 

4K 

0000  —  37FF 

RAM 

14K 

1000  — 37FF 

RAM  (Read  Only) 

10K 

3800  — 3BFF 

Keyboard 

1K 

37E8  —  37E9 

Printer  Status  (Read  Only) 

2 

3C0O  —  3FFF 

Video 

1K 

3800  —  3BFF 

Keyboard 

1K 

4000  — FFFF 

RAM 

48K 

3C0O  — 3FFF 

Video 

1K 

4000  —  FFFF 

RAM 

48K 

Mode  2 

SELO    -  0    -  OV 
SEL1    -  1         +5V 

ModeO 

SELO 
SEL1 

-  0        OV 

-  0   -  OV 

ROM    -  X  -  Don  t  Care 

ROM 

-  0    -   -r5V 

0000  —  F3FF 
F400  —  F7FF 

RAM 
Keyboard 

61K 
1K 

0000  —  37FF 

RAM  (Read  Only) 

14K 

F800  —  FFFF 

Video 

2K 

37E8  — 37E9 

Printer  Status  (Read  Only) 

2 

3800  —  38  FF 

Keyboard 

1K 

3C00  —  3FFF 

Video 

1K 

Mode  3 

SELO    =1    -    -r5V 

4000  — FFFF 

RAM 

48K 

SEL1    =1    -   +5V 
ROM    -  X  -  Don  t  Care 

Mode  1 

SELO 
SEL1 
ROM 

-  1    -   +5V 

-  o  -  OV 

-  1    -  OV 

0000—  FFFF 

RAM 

64K 

0000  —  OFFF 

Boot  ROM 

4K 

0000  —  OFFF 

RAM  (Write  Only) 

4K 

1000  — 37FF 

RAM 

10K 

3800  — 3BFF 

Keyboard 

1K 

3C00  —  3FFF 

Video 

1K 

4000  — FFFF 

RAM 

48K 

-\ 
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I/O  Port  Assignment 


Normally 

Port* 

Used 

Out 

In 

FC  — FF 

FF 

CASSOUT ' 

MODIN* 

F8  — FB 

F8 

LPOUT ' 

LPIN* 

F4  — F7 

F4 

DRVSEL ' 

(RESERVED) 

FO  — F3 

- 

DISKOUT  * 

DISKIN  * 

FO 

FO 

FDC  COMMAND  REG. 

FDC  STATUS  REG. 

F1 

F1 

FDC  TRACK  REG. 

FDC  TRACK  REG. 

F2 

F2 

FDC  SECTOR  REG. 

FDC  SECTOR  REG. 

F3 

F3 

FDC  DATA  REG. 

FDC  DATA  REG. 

EC— EF 

EC 

MODOUT  * 

RTCIN  * 

E8  —  EB 

- 

RS2320UT  * 

RS232IN  * 

E8 

E8 

UART  MASTER  RESET 

MODEM  STATUS 

E9 

E9 

BAUD  RATE  GEN.  REG. 

(RESERVED) 

EA 

EA 

UART  CONTROL  AND 
MODEM  CONTROL  REG 

UART  STATUS  REG. 

EB 

EB 

UART  TRANSMIT 

UART  HOLDING  REG 

HOLDING  REG 

(RESET  D.R.) 

E4  — E7 

E4 

WR  NMI  MASK  REG.  ' 

RD  NMI  STATUS  ' 

EO—  E3 

EO 

WR  INT  MASK  REG.  * 

RD  INT  MASK  REG.  * 

AO  — DF 

- 

(RESERVED) 

(RESERVED) 

9C  — 9F 

9C 

BOOT* 

(RESERVED) 

94  — 9B 

„ 

(RESERVED) 

(RESERVED) 

90  —  93 

90 

SEN* 

(RESERVED) 

8C  — 8F 

- 

GSELO  * 

GSELO  * 

88  —  8B 

- 

CRTCCS  * 

(RESERVED) 

88.  8A 

88 

CRCTADD.  REG 

(RESERVED) 

89,  8B 

89 

CRCT  DATA  REG. 

(RESERVED) 

84  —  87 

84 

OPREG  * 

(RESERVED) 

80  —  83 

- 

GSEL1  * 

GSEL1  * 

o 
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I/O  Port  Description 

Name:  CASSOUT ' 

Port  Address:   FC  — FF 
Access:  WRITE  ONLY 

Description:      Output  da(a  to  cassette  or  tor  sound 
generation 

Note:      The  Model  4P  does  not  support  cassette  storage, 
this  port  is  only  used  to  generate  sound  that  was  to 
be  output  via  cassette  port.  The  Model  4P  sends 
data  to  onboard  sound  circuit. 

DO  =  Cassette  output  level  (sound  data  output) 

D1  =  Reserved 

D2  — 07      =  Undefined 


Name:  MODIN  *  (CASSIN  *) 

Port  Address:    FC  — FF 
Access:  READ  ONLY 

Description:      Configuration  Status 


DO 

=  0 

D1 

=  CASSMOTORON  STATUS 

D2 

=  MODSEL  STATUS 

D3 

=  ENALTSET  STATUS 

D4 

=  ENEXTIO  STATUS 

OS 

=  (NOT  USED) 

D8 

=  FAST  STATUS 

07 

=  0 

Name:  LPOUT  * 

Port  Address:  F8  —  FB 

Access:  WRITE  ONLY 

Description:  Output  data  to  line  printer 


DO—  D7 


ASCII  BYTE  TO  BE  PRINTED 


Name:  LPIN " 

Port  Address:  F8  — FB 

Access:  READ  ONLY 

Description:  Input  line  printer  status 


DO— D3 

-  (RESERVED) 

04 

-  FAULT 

1  -  TRUE 

0  =  FALSE 

OS 

=  UNIT  SELECT 

1  =  TRUE 

0  =  FALSE 

D6 

=  OUTPAPER 

1  =  TRUE 

0  =  FALSE 

D7 

=  BUSY 

1  =  TRUE 

0  -  FALSE 

Name:  DRVSEL  * 

Port  Address:  F4  —  F7 

Access:  WRITE  ONLY 

Description:  Output  FDC  Configuration 

Note:      Output  to  this  port  will  ALWAYS  cause  a  1  -2  msec. 
(Microsecond)  wait  to  the  Z80. 


DO 

=  DRIVE  SELECT  0 

D1 

=  DRIVE  SELECT  1 

D2 

=  (RESERVED) 

D3 

=  (RESERVED) 

D4 

=  SDSEL 

0  =  SIDE  0 

1  =  SIDE  1 

D5  =  PRECOMPEN 

0  =  No  write  precompensation 

1  =  Write  Precompensation  enabled 

D6  =  WSGEN 

0  =  No  wait  state  generated 

1  =  wait  state  generated 

Note:      This  wait  state  is  to  sync  Z80  with  FDC  chip  during 
FDC  operation. 


D7 


DDEN" 

0  =  Single  Density  enabled  (FM) 

1  =  Double  Density  enabled  (MFM) 
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Name:  DtSKOUT  * 

Port  Address:  FO— F3 

Access:  WRITE  ONLY 

Description:  Output  to  FDC  Control  Registers 

Port  FO  =  FDC  Command  Register 

PortFI  =  FDC  Track  Register 

Port  F2  =  FDC  Sector  Register 

Port  F3  =  FDC  Data  Register 

(Refer  to  FDC  Manual  ior  Bit  Assignments) 

Name:  DISKIN ' 

Port  Address:   FO  —  F3 

Access:  READ  ONLY 

Description:      Input  FDC  Control  Registers 

Port  FO  =  FDC  Status  Register 

Port  F1  =  FDC  Track  Register 

Port  F2  =  FDC  Sector  Register 

Port  F3  =  FDC  Data  Register 

(Reler  to  FDC  Manual  for  Bit  Assignment) 


Name:  MODOUT ' 

Port  Address:  EC  — EF 

Access:  WRITE  ONLY 

Description:  Output  to  Configuration  Latch 


DO 

D1 

D2 
D3 


(RESERVED) 

CASSMOTORON  (Sound  enable) 

0  =  Cassette  Motor  Otf  (Sound  enabled) 

1  =  Cassette  Motor  On  (Sound  disabled) 

MODSEL 

0  =  64  or  80  character  mode 

1  =  32  or  40  character  mode 

ENALTSET 

0  =  Alternate  character  set  disabled 

1  =  Alternate  character  set  enabled 


D4 

-  ENEXTIO 

0  -  External  IO  Bus  disabled 

1  -  External  IO  Bus  enabled 

D5 

=  (RESERVED) 

D6 

=  FAST 

0-2  MHZ  Mode 

1  =  4  MHZ  Mode 

D7 

=  (RESERVED) 

# 


Name:  RTCIN  - 

Port  Address:   EC—  EF 

Access:  READ  ONLY 

Description:      Clear  Real  Time  Clock  Interrupt 


DO—  D7 


DON  T  CARE 


Name:  RS2320UT ' 

Port  Address:   E8  —  EB 
Access:  WRITE  ONLY 

Description:      UART  Control  Data  Control  Modem  Control, 
BRG  Control 

Port  E8  =  UART  Master  Reset 

Port  E9  -  BAUD  Rate  Gen  Register 

Port  EA  =  UART  Control  Register  (Modem  Control  Reg  ) 

Port  EB  =  UART  Transmit  Holding  Reg 

(Refer  to  Model  III  or  4  Manual  for  Bit  Assignments) 

Name:  RS232IN " 

Port  Address:  E8  — EB 

Access:  READ  ONLY 

Description:      Input  UART  and  Modem  Status 

Port  E8  =  MODEM  STATUS 

Port  E9  =  (RESERVED) 

Port  EA  =  UART  Status  Register 

Port  EB  -  UART  Receive  Holding  Register  (Resets  DR) 

(Refer  to  Model  III  or  4  Manual  for  Bit  Assignments) 


C 
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Name:  WRNMIMASKREG 

Port  Address:  E4  —  E7 

Access:  WRITE  ONLY 

Description:  Output  NMI  Latch 

DO  — D5      =  (RESERVED) 


06 


ENMOTOROFFINT 

0  =  Disables  Motoroff  NMI 

1  =  Enables  Motoroff  NMI 


D5 


D6 


D7 


ENRECINT 

0  =  RS232  Rec  Data  Reg.  full  int.  disabled 

1  -  RS232  Rec.  Data  Reg-  full  int  enabled 

ENERRORINT 

0  =  RS232  UART  Error  interrupts  disabled 

1  =  RS232  UART  Error  interrupts  enabled 

(RESERVED) 


07  =  ENINTRQ 

0  =  Disables  INTRQ  NMI 

1  =  Enables  INTRQ  NMI 


Name: 

Port  Address: 

Access: 

Description: 


RDNMISTATUS  * 

E4  — E7 
READ  ONLY 
Input  NMI  Status 


DO 

D2  — D4 
OS 

06 

D7 


0 


=  (RESERVED) 

=  RESET  (not  needed) 

0  =  Reset  Asserted  (Problem) 

1  =  Reset  Negated 

=  MOTOROFF 

0  =  Motoroff  Asserted 

1  =  Motoroff  Negated 

=  INTRQ 

0  =  INTRQ  Asserted 

1  =  INTRQ  Negated 


Name:  WRINTMASKREG ' 

Port  Address:   EO  — E3 
Access:  WRITE  ONLY 

Description:      Output  INT  Latch 

DO—  D1       =  (RESERVED) 


D2 


D3 


ENRTC 

0  =  Real  time  clock  interrupt  disabled 

1  =  Real  time  clock  interrupt  enabled 

ENIOBUSINT 

0  =  External  10  Bus  interrupt  disabled 

1  =  External  10  Bus  interrupt  enabled 


Name:  RDINTSTATUS  * 

Port  Address:   EO— E3 
Access:  READ  ONLY 

Description:      Input  INT  Status 


DO- 

-D1 

-  (RESERVED) 

D2 

=  RTC  INT 

D3 

=  IOBUS  INT 

D4 

=  RS232  XMIT  INT 

D5 

=  RS232  REC  INT 

D6 

=  RS232  UART  ERROR  INT 

D7 

=  (RESERVED) 

Name:  BOOT  * 

Port  Address:  9C  — 9F 

Access:  WRITE  ONLY 

Description:  Enable  or  Disable  Boot  ROM 

DO  =  ROM ■ 

0  =  Boot  ROM  Disabled 

1  =  Boot  ROM  Enabled 

D1— D7       -(RESERVED) 


Name:  SEN  * 

Port  Address:  90  —  93 

Access:  WRITE  ONLY 

Description:  Sound  output 

DO  =  SOUND  DATA 

D1— D7       =  (RESERVED) 


D4 


ENXMITINT 

0  =  RS232  Xmit  Holding  Reg.  empty  int. 
disabled 

1  =   RS232  Xmit  Holding  Reg.  empty  int. 
enabled 
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Name: 

OPREG  * 

Port  Address: 

84 

Access: 

WRITE  ONLY 

Description: 

Output  to  operation  reg 

DO 


=  SELO 


D1 


SEL1 


D2 


SEL1 

SELO 

MODE 

0 

0 

0 

0 

1 

1 

1 

0 

2 

1 

1 

3 

8064 

0  = 

64  character  mode 

1  = 

80  character  mode 

• 


D3 


INVERSE 

0  =  Inverse  video  disabled 

1  =    Inverse  video  enabled 


D4 


D5 


D6 


=  SRCPAGE  —  Points  to  the  page  lo  be  mapped 
as  new  page 

0  =  U64K,  L32K  Page 

1  =  U64K,  U32K  Page 

=  EN  PAGE  —  Enables  mapping  ol  new  page 

0  =  Page  mapping  disabled 

1  =  Page  mapping  enabled 

=  DESPAGE  —  Pomts  to  the  page  where  new 
page  is  to  be  mapped 

0  =  L64K,  U32K  Page 

1  =  L64K,  L32K  Page 


C 


D7 


PAGE 

0  =  Page  0  of  Video  Memory 

1  =  Page  1  of  Video  Memory 
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3.1.8  Video  Circuit 

The  heart  of  the  video  display  circuit  in  the  Model  4P  is  the 
68045  Cathode  Ray  Tube  Controller  (CRTC),  U85  The  CRTC 
is  a  preprogrammed  video  controller  that  provides  two  screen 
formats  64  by  16  and  80  by  24  The  format  is  controlled  by  pin 
3  of  the  CRTC  (8064*)  The  CRTC  generates  all  of  the  neces- 
sary signals  required  for  the  video  display  These  signals  are 
VSYNC  (Vertical  Sync),  HSYNC  (Horizontal  Sync)  lor  proper 
sync  ot  the  monitor,  DISPEN  (Display  Enable)  which  indicates 
when  video  data  should  be  output  to  the  monitor,  the  refresh 
memory  addresses  (MAO-MA  13)  which  addresses  the  video 
RAM,  and  the  row  addresses  (RA0-RA4)  which  indicates  which 
scan  line  row  is  being  displayed  The  CRTC  also  provides  hard- 
ware scrolling  by  writing  to  the  internal  Memory  Start  Address 
Register  by  OUTing  to  Port  88H  The  internal  cursor  control  of 
the  68045  is  not  used  in  the  Model  4P  video  circuit 

Since  the  80  by  24  screen  requires  1,920  screen  memory  lo- 
cations, a  2K  by  8  static  RAM  (U82)  is  used  lor  the  video  RAM 
Addressing  to  the  video  RAM  (U82)  is  provided  by  the  68045 
when  refreshing  the  screen  and  by  the  CPU  when  updating  of 
the  data  is  performed  These  two  sets  of  address  lines  are  mul- 
tiplexed by  three  74LS157S  (U83,  U84,  and  U104)  The  multi- 
plexers are  switched  by  CRTCLK  which  allows  the  CRTC  to 
address  the  video  RAM  dunng  the  high  state  of  CRTCLK  and 
the  CPU  access  during  the  low  state  A10  from  the  CPU  is  con- 
trolled by  PAGE*  which  allows  two  display  pages  in  the  64  by 
16  format  When  updates  to  the  video  RAM  are  performed  by 
the  CPU,  the  CPU  is  held  in  a  WAIT  state  until  the  CRTC  is  not 
addressing  the  video  RAM  This  operation  allows  reads  and 
writes  1o  video  RAM  without  causing  hashing  on  the  screen 
The  circuit  that  performs  this  function  is  a  74LS244  buffer 
(U103),  an  8  bit  transparent  latch,  74LS373  (U102)  and  a  Delay 
line  circuit  shared  with  Dynamic  RAM  timing  circuit  consisting 
Of  a  74LS74  (U95),  74LS32  (U94),  74LS04  (U74).  74LS00 
(U96),  74LS02  <U75),  and  Delay  Line  (U97)  Dunng  a  CPU 
Read  Access  1o  the  Video  RAM,  the  address  is  decoded  by  the 
PAL  U109  and  asserts  VIDEO*  low  This  is  inverted  by  U74  (1/ 
6  of  74LS04)  which  pulls  one  input  of  U96  (1  /4  of  74LS00)  and 
in  turn  asserts  VWAIT  "  low  to  the  CPU  RD  is  high  at  this  time 
and  is  latched  into  U95  (1/2  of  74LS74)  on  the  rising  edge  of 
XADR7"  XADR7*  is  inverse  of  CRTCLK  which  drives  the 
CRTC  (68045),  and  the  address  multiplexers  U83,  U84.  and 
U104 


When  RD  is  latched  by  U95  the  Q  output  goes  low  releasing 
WAIT"  from  the  CPU  The  same  signal  also  is  sent  to  the  Delay 
Line  (U97)  through  U1 16  (1  4  of  74F08)  The  Delay  line  delays 
the  falling  edge  240  ns  for  VLATCH*  which  latches  the  read 
data  from  the  video  RAM  at  U 102  The  data  is  latched  so  the 
CRTC  can  refresh  the  next  address  location  and  prevent  any 
hashing  MRD*  decoded  by  U108  and  a  memory  read  is  ORed 
with  VIDEO"  which  enables  ihe  data  from  U102tothedatabus 
The  CPU  then  reads  the  data  and  completes  the  cycle  A  CPU 
write  is  slightly  more  complex  in  operation  As  in  the  RD  cycle, 
VIDEO"  is  asserted  low  which  asserts  VWAIT'  low  to  the  CPU 
WR  is  high  at  this  time  which  is  NANDed  with  VIDEO  and 
synced  with  CRTCLK  to  create  VRAMDIS  that  disables  the 
video  RAM  output  On  the  rising  edge  of  XADR7",  WR  is 
latched  into  U95  (1/2  of  74LS74)  which  releases  VWAIT*  and 
starts  cycle  through  the  Delay  Line  After  30ns  DLYVWR"  (De- 
layed video  write)  is  asserted  low  which  also  asserts  VBUFEN* 
(Video  Buffer  Enable)  low  VBUFEN*  enabled  data  from  the 
Data  bus  to  the  video  RAM  Approximately  120ns  later 
DLYVWR*  is  negated  high  which  writes  the  data  to  the  video 
RAM  and  negates  VBUFEN*  turning  off  buffer  The  CPU  then 
completes  WR  cycle  to  the  video  RAM  Refer  to  Video  RAM 
CPU  Access  Timing  Figure  5-12  lor  timing  of  above  RD  or  WR 
cycles 

During  screen  refresh,  CRTCLK  is  high  allowing  the  CRTC  to 
address  Video  RAM  The  data  out  of  the  video  RAM  is  latched 
by  LOAD*  into  a  74LS273  (U101)  D7  is  generated  by  IN- 
VERSE* through  U125  (1/6  of  74S04),  and  U123  (1/4  of 
74LS08)  This  decoding  determines  if  character  should  be  al- 
pha-numeric only  (if  inverse  high)  or  unchanged  (INVERSE* 
low)  The  outputs  of  U101  are  used  as  address  inputs  the  char- 
acter generator  ROM  (U42)  A9  is  decoded  with  ENALTSET 
(Enable  Alternate  Set)  and  Q7  of  U101 ,  which  resets  A9  to  a 
low  if  Q7  and  ENALTSET  are  high  See  ENALTSET  Control  Ta- 
ble below 


ENALTSET 

Q7 

Q6 

A9 

0 

0 

0 

0 

0 

1 

0 

0 

0 

1 

1 

1 

1 

0 

0 

0 

1 

0 

1 

1 

1 

1 

0 

0 

1 

1 

1 

0 
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RA0-RA3  row  addresses  from  the  CRTC  are  used  to  control 
which  scan  line  is  being  displayed  The  Model  4P  has  a  4-bit  full 
adder  74LS283  (U61)  to  modify  the  Row  address  During  a 
character  display  DLYGRAPHIC"  is  high  which  applies  a  high  to 
all  4  bits  to  be  added  to  row  address  This  will  result  in  subtract- 
ing one  from  Row  address  count  and  allow  all  characters  to  be 
displayed  one  scan  line  lower  The  purpose  is  so  inverse  char- 
acters will  appear  within  the  inverse  block  When  a  graphic 
block  is  displayed  DLYGRAPHIC*  is  tow  which  causes  the  row 
address  to  be  unmodilied  Moving  jumper  from  E14-E15  to 
E15-E16  will  disable  this  circuit 

DLYCHAR*  and  DLYGRAPHICS  are  inverse  signals  and  con- 
trol which  data  is  to  be  loaded  into  the  shift  register  U63 
When  DLYCHAR*  is  low  and  DLYGRAPHIC*  is  high,  the 
Character  Generator  ROM  (U42)  is  enabled  to  output  data 
when  DLYCHAR*  is  high  and  DLYGRAPHIC*  is  low  the 
graphics  characters  from  U41  (74LS15)  is  buffered  by  U43 
(74LS244)  to  the  shift  register  The  data  is  loaded  into  the 
shift  register  on  the  rising  edge  of  SHIFT*  when  LOADS*  is 
low  Blanking  is  accomplished  by  masking  off  LOADS"  so  no 
data  will  be  loaded  and  zero  data  will  be  shifted  out  with  the 
serial  input  of  U63,  pin  1 ,  grounded  Senal  video  data  is  oul- 
put  U63  pin  13  and  is  mixed  with  inverse  and/or  hires  graph- 
ics information  by  (1/4  or  74LS86)  U143  The  video  data  is 
then  mixed  with  a  D07  Rale  clock,  either  DOT"  and  DCLK, 
to  creale  distinct  dots  on  the  monitor  DOT"  and  DCLK  are 
inverse  signals  and  are  provided  to  allow  a  choice  to  obtain 
the  best  video  results  The  video  information  is  filtered  by 
F34,  R45  (47  ohm  resistor),  and  C241  (100  pf  Cap)  and  out- 
put to  video  monitor  VSYNC  and  HSYNC  are  buffered  by 
(1/2  of  74LS86)  U143  and  are  also  output  to  video  monitor 
Refer  to  Video  Circuit  Timing  Figure  3-13,  Video  Blanking 
Timing  Figure  3-14,  and  Inverse  Video  Timing  Figure  3-15 
for  liming  relationships  of  Video  Circuit 

3.1.9  Keyboard 

The  keyboard  interface  of  the  Model  4P  consists  of  open  col- 
lector drivers  which  drive  an  8  by  8  key  matrix  keyboard  and  an 
inverting  buffer  which  buffers  the  key  or  keys  pressed  on  the 
data  bus  The  open  collector  drivers  (U56  and  U57  (7416)  are 
driven  by  address  lines  A0-A7  which  drive  the  column  lines  of 
the  keyboard  matrix  The  ROW  lines  ot  the  keyboard  are  pulled 
up  by  a  1  5  kohm  resistor  pack  RP2  The  ROW  lines  are  buff- 
ered and  inverted  onto  the  data  bus  by  U58  (74LS240)  which  is 
enabled  when  KEYBD'  is  a  logic  low  KEYBD*  is  a  memory 
mapped  decode  ot  addresses  3800-3BFF  in  Model  HI  Mode 
and  F400-F7FF  in  Model  4/4P  mode  Refer  to  the  Memory  Map 
under  Address  Decode  for  more  information  During  real  time 
operation,  the  CPU  will  scan  the  keyboard  periodically  to  check 
if  any  keys  are  pressed  If  no  key  is  pressed,  the  resistor  pack 
RP2  keeps  the  inputs  of  U58  at  a  logic  high  U58  inverts  the 
data  to  a  logic  low  and  buffers  it  to  the  data  bus  which  is  read 
by  the  CPU  If  a  key  is  pressed  when  the  CPU  scans  the  correct 
column  line,  the  key  pressed  will  pull  the  corresponding  row  to 
a  logic  low  U58  inverts  the  signal  to  a  logic  high  which  is  read 
by  the  CPU 


3.1.10  Real  Time  Clock 

The  Real  Time  Clock  circuit  in  the  Model  4P  provides  a  30  Hz 
(in  the  2  MHz  CPU  mode)  or  60  Hz  (in  the  4  MHz  CPU  mode) 
interrupt  to  the  CPU  By  counting  the  number  of  rnterrupts  that 
have  occurred,  the  CPU  can  keep  track  of  the  time  The  60  Hz 
vertical  sync  signal  (VSYNC)  from  the  video  circuitry  is  used  for 
the  Real  Time  Clock  s  reference  In  the  2  MHz  mode,  FAST  is 
a  logic  low  which  sets  the  Preset  input,  pin  4  of  U22  (74LS74), 
to  a  logic  high  This  allows  Ihe  60  Hz  (VSYNC)  to  be  divided  by 
2  to  30  Hz  The  output  of  1/2  of  U22  is  ORed  with  the  original 
60  Hz  and  then  clocks  another  74LS74  (1/2  of  U22)  If  the  real 
time  clock  is  enabled  (ENRTC  at  a  logic  high),  the  interrupt  is 
latched  and  pulls  the  INT*  line  low  to  the  CPU  When  the  CPU 
recognizes  the  interrupt,  the  pulse  is  counted  and  the  latch  re- 
set by  pulling  RTCIN"  tow  In  the  4  MHz  mode,  FAST  is  a  logic 
high  which  keeps  the  first  half  of  U22  in  a  preset  state  (the  Q* 
output  at  a  logic  low)  The  60  Hz  is  used  to  clock  the  interrupts 

NOTE:  If  interrupts  are  disabled,  the  accuracy  of  the  real 
time  clock  will  suffer 

3.1.11  Line  Printer  Port 

The  Line  Printer  Port  Interface  consists  of  a  pulse  generator,  an 
eight-bit  latch,  and  a  status  line  buffer  The  status  of  the  line 
printer  is  read  by  the  CPU  by  enabling  buffer  U3  (74LS244) 
This  buffer  is  enabled  by  LPRD"  which  is  a  memory  map  and 
port  map  decode  In  Model  III  mode,  only  the  status  can  be  read 
from  memory  location  37E8  or  37E9  The  status  can  be  read  in 
ail  modes  by  an  input  from  ports  F8-FB  For  a  listing  of  the  bit 
status,  refer  to  Port  Map  section 

After  the  printer  driver  software  determines  that  the  printer  is 
ready  for  printing  (by  reading  the  correct  status) ,  the  characters 
to  be  printed  are  output  to  Port  F8-FB  U2,  a  74LS374  eight-bit 
latch,  latches  the  character  byte  and  outputs  to  the  line  printer 
One-half  of  U1  (74LS123),  a  one-shot,  is  then  triggered  which 
generates  an  appropriate  strobe  signal  to  the  printer  which  sig- 
nrfies  a  valid  character  is  ready  The  output  of  the  one-shot  is 
buffered  by  1/6th  of  the  U21  (74LS04)  to  prevent  noise  from  ihe 
printer  cable  from  flase-tnggering  the  one-shot 
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The  Graphics  Port  (J7)  on  the  Model  4P  is  provided  to  attach 
the  optional  Graphics  Board  The  port  provides  D0-D7  (Data 
Lines),  A0-A3  (Address  Lines),  IN*.  GEN*  and  RESET*  lor  the 
necessary  interface  signals  for  the  Graphics  Board  GEN*  is 
generated  by  negative  ORmg  Port  selects  GSELO*  (8C-8FH) 
and  GSELI*  (80-83H)  together  by  (1  4  of  74LS08)  U23  The  re- 
sulting signal  is  negative  ANDed  with  IORQ*  by  (1  4  of  74S32) 
U62  Seven  timing  signals  are  provided  to  allow  synchroniza- 
tion of  Main  Logic  Board  Video  and  Graphics  Board  Video 
These  timing  signals  are  VSYNC,  HSYNC,  DISPEN,  DCLK,  H, 
I,  and  J  Three  control  signals  from  ihe  Graphics  Board  are 
used  to  sync  to  CPU  access  and  select  different  video  modes 
WAIT*  controls  the  CPU  access  by  causing  the  CPU  to  WAIT  till 
video  is  in  retrace  area  before  allowing  any  writes  or  reads  to 
Graphics  Board  RAM  ENGRAF  is  asserted  when  Graphics 
video  is  displayed  ENGRAF  also  disables  inverse  video  mode 
on  Mam  Logic  Board  Video  CL166*  (Clear  74L166)  is  used  to 
enable  or  disable  mixing  of  Main  Logic  Board  Video  and  Graph- 
ics Board  Video  If  CL166"  is  negated  high,  then  mixing  is  al- 
lowed in  all  for  video  modes  80  x  24,  40  x  24, 64  x  16.  and  32  x 
16.  If  CL166*  is  asserted  low,  this  will  clear  the  video  shift  reg- 
ister U63,  which  allows  no  video  from  the  Main  Logic  Board  In 
this  state  8064*  is  automatically  asserted  low  to  put  screen  in 
80  x  24  video  mode  Refer  to  Figure  3-16  Graphic  Board 
Video  Timing  lor  timing  relationships  Refer  to  the  Model  4/ 
4P  Graphics  Board  Service  information  for  service  or  techni- 
cal information  on  the  Graphics  Board 

3.1.13  Sound 

The  sound  circuit  in  the  Model  4P  is  compatible  with  the  Sound 
Board  which  was  optional  in  the  Model  4  Sound  is  generated 
by  alternately  setting  and  clearing  data  bit  DO  during  an  OUT  to 
port  90H  The  state  of  DO  is  latched  by  U1 30  (1/2  of  a  74LS74) 
and  the  output  is  amplified  by  Q2  which  drives  a  piezoelectric 
sound  transducer  The  speed  of  the  software  loop  determines 
the  frequency,  and  thus,  the  pitch  of  the  resulting  tone  Since 
Ihe  Model  4P  does  not  have  a  cassette  circuit,  some  existing 
software  that  used  the  cassette  output  for  sound  would  have 
been  lost  The  Model  4P  routes  the  cassette  latch  to  the  sound 
board  through  U142  When  the  CASSMOTORON  signal  is  a 
logic  low,  the  cassette  motor  is  off,  then  the  cassette  output  is 
sent  to  the  sound  circuit 

3.1.14  I/O  Bus  Port 

The  Model  4P  Bus  is  designed  to  allow  easy  and  convenient  in- 
terfacing of  I/O  devices  to  the  Model  4P  The  I O  Bus  supports 
all  the  signals  necessary  to  implement  a  device  compatible  with 
the  Z80s  I/O  structure 


A0  to  A7  allow  selection  of  up  to  256*  input  and  256  output 
devices  if  external  I  O  is  enabled 

"Ports  80H  to  0FFH  are  reserved  for  System  use 

Data 

DB0  to  DB7  allow  transfer  of  8-bit  data  onto  the  processor 
data  bus  is  external  I  O  is  enabled 

Control  Lines 

1  M1*  —  Z80A  signal  specifying  an  M1  or  Operation  Code 
Fetch  Cycle  or  with  IOREO*,  it  specifies  an  Interrupt 
acknowledge 

2  IN*  —  Z80A  signal  specifying  than  an  input  is  in  progress 
Logic  AND  of  IOREQ*  and  WR* 

3  OUT*  —  Z80A  signal  specifying  that  an  output  is  in  prog- 
ress Logic  AND  of  IOREQ*  and  WR* 

4  IOREQ"  —  Z80A  signal  specifying  that  an  input  or  output 
is  in  progress  or  with  M1*.  it  specifies  an  interrupt 
acknowledge 

5  RESET*  —  system  reset  signal 

6  IOBUSINT*  —  input  to  the  CPU  signaling  an  interrupt  from 
an  I/O  Bus  device  if  I/O  Bus  interrupts  are  enabled. 

7  IOBUSWAIT*  —  input  to  the  CPU  wait  line  allowing  I/O  Bus 
device  to  force  wait  states  on  the  Z80  i)  external  I/O  is 
enabled 

8  EXTIOSEL*  —  input  to  I/O  Bus  Port  circuit  which  switches 
the  I/O  Bus  data  bus  transceiver  and  allows  and  INPUT  in- 
struction to  read  I/O  Bus  data 

The  address  line,  data  line,  and  all  control  lines  except  RESET" 
are  enabled  only  when  the  ENEXIO  bit  in  port  EC  is  set  to  one 

To  enable  I/O  interrupts,  the  ENIOBUSINT  bit  in  the  PORT  E0 
(output  port)  must  be  a  one  However,  even  if  it  is  disabled  from 
generating  interrupts,  the  status  of  the  IOBUSINT*  line  can  still 
read  on  the  appropriate  bit  of  CPU  IOPORT  E0  (input  port) 

See  Model  4P  Port  Bit  assignments  for  port  OFF,  0EC,  and  0E0 
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The  Model  4P  CPU  board  is  fully  protected  from  foreign  I  O  de- 
vices in  that  all  the  I  O  Bus  signals  are  buffered  and  can  be  dis- 
abled under  software  control  To  attach  and  use  and  I  O  device 
on  the  I  O  Bus  certain  requirements  (both  hardware  and  soft- 
ware) must  be  met 

For  input  port  device  use,  you  must  enable  external  I/O  de- 
vices by  writing  to  port  OECH  with  bit  4  on  in  the  user  soft- 
ware. This  will  enable  the  data  bus  address  lines  and  control 
signals  to  the  I/O  Bus  edge  connector.  When  the  input  de- 
vice is  selected,  the  hardware  should  acknowledge  by  as- 
serting EXTIOSEL*  low.  This  switches  the  data  bus 
transceiver  and  allows  the  CPU  to  read  the  contents  ot  the  1/ 
O  Bus  data  lines.  See  Figure  3-17  for  the  timing.  EXTIO- 
SEL* can  be  generated  by  NANDmg  IN  and  the  I/O  port 
address. 

Output  port  device  use  is  the  same  as  the  input  port  device  in 
use,  in  that  the  external  I  O  devices  must  be  enabled  by  writing 
to  port  OECH  with  bit  4  on  in  the  user  software  —  in  the  same 
fashion 

For  either  input  or  output  devices,  the  IOBUSWAIT"  control  line 
can  be  used  in  the  normal  way  for  synchronizing  slow  devices 
to  the  CPU  Note  that  since  dynamic  memories  are  used  in  the 
Model  4P,  the  wait  line  should  be  used  with  caution  Holding  the 
CPU  in  a  wait  state  for  2  msec  or  more  may  cause  loss  of  mem- 
ory contents  since  refresh  is  inhibited  during  this  time  It  is  rec- 
ommended that  the  IOBUSWAIT*  line  be  held  active  no  more 
than  500  n.sec  with  a  25%  duty  cycle 

The  Model  4P  will  support  Z80  Mode  1  interrupts  A  RAM  jump 
table  is  supported  by  the  LEVEL  It  BASIC  ROMs  image  and  the 
user  must  supply  the  address  of  his  interrupt  service  routine  by 
writing  this  address  to  locations  403E  and  403F  When  an  in- 
terrupt occurs,  the  program  will  be  vectored  to  the  user-sup- 
plied address  if  IO  Bus  interrupts  have  been  enabled  To 
enable  UO  Bus  interrupts,  the  user  must  set  bit  3  of  Port  0E0H 

3.1.15  FDC  Circuit 

The  TRS-80  Model  4P  Floppy  Disk  Interlace  provices  a  stan- 
dard 5-1  4"  floppy  disk  controller  The  Floppy  Disk  Interface 
supports  both  single  and  double  density  encoding  schemes 
Write  precompensation  can  be  software  enabled  or  disabled 
beginning  at  any  track,  although  the  system  software  enables 
write  precompensation  for  all  tracks  greater  than  twenty-one 
The  amount  of  write  precompensation  is  250  nsec  and  is  not 
adjustable  The  data  clock  recovery  logic  incorporates  a  digital 
data  separator  which  achieves  state-of-the-art  reliability  One 
or  two  drives  may  be  controlled  by  the  interlace  All  data  trans- 
fers are  accomplished  by  CPU  data  requests  In  double  density 
operation,  data  transfers  are  synchronized  to  the  CPU  by  forc- 
ing a  wart  to  the  CPU  and  clearing  the  wait  by  a  data  request 
from  the  FDC  chip  The  end  of  the  data  transfer  is  indicated  by 
generation  of  a  non-maskable  interrupt  from  the  interrupt  re- 
quest output  of  the  FDC  chip  A  hardware  watchdog  timer  in- 
sures that  any  error  condition  will  not  hang  the  wait  line  to  the 
CPU  for  a  period  long  enough  to  destroy  RAM  contents 
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Control  and  Data  Buffering 


'Only  one  of  these  bits  should  be  set  per  output 


The  Floppy  Disk  Controller  Board  is  an  I  O  port-mapped  device 
which  utilizes  ports  E4H  FOH  F1H  F2H  F3H  and  F4H  The 
decoding  logic  is  implemented  on  the  CPU  board  (Refer  to  Par 
agraph  5  1  5  Address  Decoding  for  more  information  on  Port 
Map)  U31  is  a  bi-directional  8-bit  transceiver  used  to  buffer 
dala  to  and  from  the  FDC  and  FtS-232  circuits  The  direction  of 
data  transfer  is  controlled  by  the  combination  of  control  signals 
DISKIN*  and  RS232IN*  II  either  signal  is  active  (logic  low)  U31 
is  enabled  to  drive  data  onto  the  CPU  data  bus  If  both  signals 
are  inactive  (logic  high),  U31  is  enabled  to  receive  data  from  the 
CPU  board  data  bus  A  second  buffer  ( U 1 2)  is  used  to  buff er  the 
FDC  chip  data  to  the  FDC  RS232  Data  Bus  (BD0-BD7),  U1 2  is 
enabled  all  the  time  and  it  s  direction  controlled  by  DISKIN* 
Again,  il  DISKIN*  is  active  (logic  low)  data  is  enabled  to  drive 
from  the  FDC  chip  to  the  Mam  Data  Busses  If  DISKIN"  is  in- 
active (logic  high)  data  is  enabled  to  be  transferred  to  the  FDC 
chip 

Nonmaskable  Interrupt  Logic 

Dual  D  flip-flop  U1 00  (74LS74)  is  used  to  latch  data  bits  D6  and 
D7  on  the  rising  edge  of  the  control  signal  WRNMIMASKREG* 
The  outputs  of  U100  enable  the  conditions  which  will  generate 
a  non-maskable  interrupt  to  the  CPU  The  NMI  interrupt  con- 
ditions which  are  programmed  by  doing  an  OUT  instruction  to 
port  E4H  with  the  appropriate  bits  set  If  data  bit  7  is  set,  an  FDC 
interrupt  is  enabled  to  generate  an  NMI  interrupt  If  data  bit  7  is 
reset  interrupt  requests  request  from  the  FDC  are  disabled  If 
data  bit  6  is  set  a  Motor  Time  Out  is  enabled  to  generate  an 
NMI  interrupt  If  data  bit  6  is  reset  interrupts  on  Motor  Time  Out 
are  disabled  An  IN  instruction  from  port  E4H  enables  the  CPU 
to  determine  the  source  of  the  non-maskable  interrupt  Data  bit 
7  indicates  the  status  of  FDC  interrupt  request  (INTRO) 
(0  =  true  1  false)  Data  bit  6  indicates  the  status  of  Motor 
Time  Out  (0  -  true,  1  -  false)  Data  bit  5  indicates  the  status  ol 
the  Reset  signal  (0-true,  1  -false)  The  control  signal 
RDNMISTATUS'  gates  this  status  onto  the  CPU  data  bus  when 
active  (logic  low) 

Drive  Select  Latch  and  Motor  ON  Logic 

Selecting  a  drive  prior  to  disk  I  O  operation  is  accomplished  by 
doing  an  OUT  instruction  to  port  F4H  with  the  proper  bit  set  The 
following  table  describes  the  bit  allocation  of  the  Drive  Select 
Latch 


Data  Bit 
DO 
D1 
D2 
D3 
D4 

DS 

D6 
D7 


Function 

Selects  Drive  0  when  set* 

Selects  Drive  1  when  set* 

Selects  Drive  2  when  set* 

Selects  Drive  3  when  set* 

Selects  Side  0  when  reset 

Selects  Side  1  when  set 

Write  precompensation  enabled  when  set 

disabled  when  resel 

Generates  WAIT  if  set 

Selects  MFM  mode  if  set 

Selects  FM  mode  if  reset 


Hex  D  flip-flop  U32  (74L174)  latches  the  drive  select  bits  side 
select  and  FM*  MFM  bits  on  the  rising  edge  of  the  control  signal 
DRVSEL*  A  dual  D  flip-flop  (U98)  is  used  to  latch  the  Wait  En- 
able and  Write  precompensation  enable  bits  on  the  rising  edge 
of  DRVSEL'  The  rising  edge  of  DRVSEL*  also  triggers  a  one- 
shot  (1  2  of  U54  74LS123)  which  produces  a  Motor  On  to  the 
disk  drives  The  duration  ol  the  Motor  On  signal  is  approxi- 
mately three  seconds  The  spindle  motors  are  not  designed  for 
continuous  operation  Therefore,  the  inactive  state  of  the  Motor 
On  signal  is  used  to  clear  the  Drive  Select  Latch,  which  de-se- 
lects any  drives  which  were  previously  selected  The  Motor  On 
one-shot  is  retnggerable  by  simply  executing  another  OUT  in- 
struction to  the  Drive  Select  Latch 

Wait  State  Generation  and  WAITIMOUT  Logic 

As  previously  mentioned,  a  wait  state  to  the  CPU  can  be  initi- 
ated by  an  OUT  to  the  Drive  Select  Latch  with  D6  set  Pin  5  ol 
U98  will  go  high  after  this  operation  This  signal  is  inverted  by 

I  4th  of  U79  and  is  routed  to  the  CPU  where  it  forces  the  Z80A 
into  a  wait  state  The  Z80A  will  remain  in  the  wait  state  as  long 
as  WAIT*  is  low  Once  initiated,  the  WAIT*  will  remain  low  until 
one  ol  five  conditions  is  satisfied  One  hall  ol  U77  (a  five  input 
NOR  gate)  is  used  to  perform  this  function  INTO  DRQ,  RE- 
SET, CLRWAIT,  and  WAITIMOUT  are  the  inputs  to  the  NOR 
gate  If  any  one  of  these  inputs  is  active  (logic  high)  the  output 
of  the  NOR  gate  (U77  pin  5)  will  go  low  This  output  is  tied  to  the 
clear  input  of  the  wait  latch  When  this  signal  goes  low,  it  will 
clear  the  Q  output  (U98  pin  5)  and  set  the  Q*  output  (U98  pin 
6)  This  condition  causes  WAIT*  to  go  high  which  allows  the 
280  to  exit  the  wait  state  U99  is  a  1 2-bit  binary  counter  which 
serves  as  a  watchdog  timer  to  insure  that  a  wait  condition  will 
not  persist  long  enough  to  destroy  dynamic  RAM  contents  The 
counter  is  clocked  by  a  1  MHz  clock  and  is  enabled  to  count 
when  its  reset  pin  is  low  (U99  pin  1 1 )  A  logic  high  on  U99  pin 

I I  resets  the  counter  outputs  U99  pin  15  is  a  divide-by-1024 
output  and  is  used  to  generate  the  signal  WAITIMOUT  This 
watchdog  timer  logic  will  limit  the  duration  ol  a  wait  to 
I024(jisec,  even  if  the  FDC  chip  should  fail  to  generate  a  DRQ 
or  an  INTRO 

If  an  OUT  to  Drive  Select  Latch  is  initiated  with  D6  reset  (logic 
low),  a  WAIT  is  still  generated  The  12-bit  binary  counter  will 
count  to  2  which  will  output  CLRWAIT  and  clear  the  WAIT  state 
This  allows  the  WAIT  to  occur  only  during  the  OUT  instruction 
to  prevent  violating  any  Dynamic  RAM  parameters 

NOTE:    This  automatic  WAIT  will  cause  a  1  -2  usee  wait  each 
time  an  out  to  Drive  Select  Latch  is  performed 
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Clock  Generation  Logic 

A  4  MHz  crystal  oscillator  and  a  4-bit  binary  counter  are  used  to 
generate  the  clock  signals  required  by  the  FDC  board  The  4 
MHz  oscillator  is  implemented  with  two  inverters  (1  3  of  U39) 
and  a  quartz  crystal  (Y2)  The  output  ol  the  oscillator  is  inverted 
and  buffered  by  1  6  ol  U39  to  generate  a  TTL  level  square  wave 
signal  U37  is  a  4-bit  binary  counter  which  is  divided  into  a  di- 
vide-by-2  and  a  divide-by-8  section  The  divide-by-2  section  is 
used  to  generate  the  2  MHz  output  at  pin  12  The  2  MHz  is 
NANDed  with  4MHz  by  1  4  of  U19  and  the  output  is  used  to 
clock  the  divide-by-8  section  ol  U37  A  1  MHz  clock  is  gener- 
ated at  pin  9  ot  U37  which  is  90  phase-shifted  from  the  2  MHz 
clock  This  phase  relationship  is  used  to  gate  the  guaranteed 
Write  Data  Pulse  (WD)  to  the  Write  precompensation  circuit 
The  4  MHz  is  used  to  clock  the  digital  data  separator  U18  and 
the  Write  precompensation  shift  register  U55  The  1  MHz  clock 
is  used  to  drive  the  clock  input  of  the  FDC  chip  (U13)  and  the 
clock  inpul  of  the  watchdog  timer  (U99) 

Disk  Bus  Output  Drivers 

High  current  open  collector  drivers  U20  and  U56  are  used  to 
buffer  the  output  signals  from  the  FDC  circuit  to  1he  disk  drives 

Write  Precompensation  and  Write  Data  Pulse  Shap- 
ing Logic 

The  Write  Precompensation  logic  is  comprised  of  U55 
(74LS195)  1  4  of  U19  (74LS00)  1  4  of  U74  (74LS04)  and 
1  2  of  U77  (74LS260)  U55  is  a  parallel  in  serial  out  shift  reg- 
ister and  is  clocked  by  4  MHz  which  generates  a  precompen- 
sation value  of  250  nsec  The  output  signals  EARLY  and  LATE 
of  the  FDC  chip  (U13)  are  input  to  P0  and  P2  of  the  shift  reg- 
ister A  third  signal  is  generated  by  1  4  of  U75  when  neither 
EARLY  nor  LATE  is  active  low  and  is  input  to  P1  of  U55  WD  of 
the  FDC  chip  is  NANDed  with  2  MHz  to  gate  the  guaranteed 
Write  Data  Pulse  to  U55  for  the  parallel  load  signal  SHFT  LD 
When  U55  pin  9  is  active  low  the  signals  preset  at  P1-P3  are 
clocked  in  on  the  rising  edge  of  the  4  MHz  clock  After  U55  pin 
9  goes  high  the  data  is  shifted  out  at  a  250  nsec  rale  EARLY 
will  generate  a  250  nsec  delay  NOT  EARLY  AND  NOT  LATE 
will  generate  a  500  nsec  delay  and  LATE  will  generate  a  750 
nsec  delay  This  provides  the  necessary  precompensation  for 
the  write  data  As  mentioned  previously  Write  Precompensa- 
tion is  enabled  through  software  by  an  OUT  to  the  Drive  Select 
Latch  with  bit  5  set  This  sets  the  O  output  of  the  74LS74  (U98 
pin  9)  which  is  ANDed  with  DDEN  which  disables  the  shift  reg- 
ister U55  DDEN  disables  Write  Precompensation  in  the  single 
density  mode  The  resulting  signal  also  enables  U75  to  allow 
the  write  data  (WD)  to  bypass  the  Write  Precompensation  cir- 
cuit The  Write  Data  (WD)  pulse  is  shaped  by  a  one-shot  ( 1  2  of 
U54)  which  stretches  the  data  pulses  to  approximately  500 
nsec 
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Clock  and  Read  Data  Recovery  Logic 


BRG  Programming  Table 


The  Clock  and  Read  Data  Recovery  Logic  is  comprised  of  one 
chip  U18  (FDC921 6)  The  FDC921 6  is  a  Floppy  Disk  Data  Sep- 
arator (FDDS)  which  converts  a  single  stream  of  pulses  from 
the  disk  drive  into  separate  clock  and  data  pulses  for  input  to 
the  FDC  chip  The  FDDS  consists  ol  a  clock  divider  a  long-term 
timing  corrector  a  short-time  liming  corrector  and  reclocking 
circuitry  The  reference  clock  (REFCLK)  is  a  4  MHz  and  is  di- 
vided by  the  internal  clock  divider  CDO  and  CD1  of  the  FDDS 
chip  control  the  divisor  which  divides  REFCLK  With  DC1 
grounded  (logic  low),  CDO  (when  a  logic  low)  generates  a  di- 
vide-by-1  for  MFM  mode  and  when  logic  high  generates  a  di- 
vide-by-2  for  FM  mode  CDO  is  controlled  by  the  signal  DDEN* 
which  is  Double  Density  enable  or  MFM  enable  The  FDDS  de- 
tects the  leading  edges  of  RD"  pulses  and  adjusts  the  phase  of 
the  internal  clock  to  generate  the  separated  clock  (SEPCLK)  to 
the  FDC  chip  The  separate  long  and  short  term  timing  correc- 
tors assure  the  clock  separation  to  be  accurate  The  separated 
Data  (SEPD*)  is  used  as  the  RDD*  input  to  the  FDC  chip 

Floppy  Disk  Controller  Chip 

The  1793  is  an  MOS  LSI  device  which  performs  the  functions 
of  a  floppy  disk  formattercontroller  in  a  single  chip  implemen- 
tation The  following  port  addresses  are  assigned  to  the  internal 
registers  of  the  1 793  FDC  chip 


Port  No. 

Function 

FOH 

Command  Status  Register 

F1H 

Track  Register 

F2H 

Sector  Register 

F3H 

Data  Register 

3.1.16  RS-232-C  Circuit 
RS-232C  Technical  Description 

The  RS-232C  circuit  for  the  Model  4P  computer  supports  asyn- 
chronous serial  transmissions  and  conforms  to  the  EIA  RS- 
232C  standards  at  the  tnput-output  interface  connector  (J4) 
The  heart  of  the  circuit  is  the  TR1865  Asynchronous  Receiver 
Transmitter  U30  It  performs  the  job  of  converting  the  parallel 
byte  data  from  the  CPU  to  a  serial  data  stream  including  start 
stop,  and  parity  bits  For  a  more  detailed  description  of  how  this 
LSI  circuit  performs  these  functions  refer  to  the  TR1865  data 
sheets  and  application  notes  The  transmit  and  receive  clock 
rates  that  the  TR1865  needs  are  supplied  by  the  Baud  Rate 
Generator  U52  (BR1941L)  or  (BR  1943)  This  circuit  takes  the 
5  0688  MHz  supplied  by  the  system  timing  circuit  and  the  pro- 
grammed information  received  from  the  CPU  over  (he  data  bus 
and  divides  the  basic  clock  rate  to  provide  two  clocks  The  rates 
available  from  the  BRG  go  from  50  Baud  to  19200  Baud  See 
the  BRG  table  for  the  complete  list 


Transmit 

Receive 

Supported 

Nibble 

Baud 

16X 

by 

Loaded 

Rate 

Clock 

SETCOM 

OH 

50 

0  8  kHz 

Yes 

1H 

75 

1  2  kHz 

Yss 

2H 

110 

1  76  kHz 

Yes 

3H 

134  5 

2  1523  kHz 

Yes 

4H 

150 

2  4  kHz 

Yta 

5H 

300 

4  8  kHz 

Yes 

6H 

600 

9  6  kHz 

Yes 

7H 

1200 

19  2  kHz 

Yes 

8H 

1800 

28  8  kHz 

Yes 

9H 

2000 

32  081  kHz 

Ym 

AH 

2400 

38  4  kHz 

Yes 

BH 

3600 

57  6  kHz 

Yes 

CH 

4800 

76  8  kHz 

Yes 

DH 

7200 

115  2  kHz 

Yes 

EH 

9600 

153  6  kHz 

Yes 

FH 

19200 

307  2  kHz 

Yes 

The  RS-232C  circuit  is  port  mapped  and  the  ports  used  are  E8 
to  EB  Following  is  a  description  of  each  port  on  both  input  and 
output 


Port 

Input 

Output 

E8 

Modem  status 

Master  Reset,  enables  UART 
control  register  load 

EA 

UART  status 

UART  control  register  load  and 
modem  control 

E9 

Not  Used 

Baud  rate  register  load  enable 
bit 
Transmitter  Holding  register 

EB 

Receiver  Holding 

register 

w 


Interrupts  are  supported  in  the  RS-232C  circuit  by  the  Interrupt 
mask  register  (U92)  and  the  Status  register  (U44)  which  allow 
the  CPU  to  see  which  kind  of  interrupt  has  occurred  Interrupts 
can  be  generated  on  receiver  data  register  full,  transmitter  reg- 
ister empty,  and  any  one  ol  the  errors  —  parity,  framing,  or  data 
overrun  This  allows  a  minimum  of  CPU  overhead  in  transfer- 
ring data  to  or  from  the  UART  The  interrupt  mask  register  is 
port  E0  (write)  and  the  interrupt  status  register  is  port  E0  (read) 
Refer  to  the  IO  Port  description  for  a  full  breakdown  of  all  inter- 
rupts and  their  bit  positions 
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All  Model  I,  III.  and  4  software  written  lor  the  RS-232-C  interlace 
is  compatible  with  the  Model  4P  RS-232-C  circuit,  provided  the 
software  does  not  use  the  sense  switches  to  configure  the  in- 
terface. The  programmer  can  get  around  this  problem  by  di- 
rectly programming  the  BRG  and  UART  for  the  desired 
configuration  or  by  using  the  SETCOM  command  of  the  disk 
operating  system  to  configure  the  interface  .  The  TRS-80  RS- 
232C  Interface  hardware  manual  has  a  good  discussion  of  the 
RS-232C  standard  and  specific  programming  examples  (Cat- 
alog Number  26-1 145). 

Pinout  Listing 

The  following  list  is  a  pinout  description  of  the  DB-25  connector 
(P1). 

Pin  No.  Signal 

1  PGND  (Protective  Ground) 

2  TD  (Transmit  Data) 

3  RD  (Receive  Data) 

4  RTS  (Request  to  Send) 

5  CTS  (Clear  To  Send) 

6  DSR  (Data  Set  Ready) 

7  SGND  (Signal  Ground) 

8  CD  (Carrier  Detect) 

1 9  SRTS  (Spare  Request  to  Send) 

20  DTR  (Data  Terminal  Ready) 
22  Rl  (Ring  Indicate) 
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4P  GATE  ARRAY  THEORY  OF  OPERATION 
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4.2  MODEL  4P  GATE  ARRAY  THEORY  OF 
OPERATION 

4.2.1  Introduction 

Contained  in  the  following  paragraphs  is  a  description  of  the 
component  parts  of  the  Model  4P  CPU  Gate  Array  It  is  divided 
into  the  logical  operational  functions  of  the  computer  All  com- 
ponents are  located  on  the  Main  CPU  board  inside  the  case 
housing  Refer  to  Section  3  for  disassembly  assembly 
procedures 

4.2.2  Reset  Circuit 

The  Model  4P  reset  circuit  provides  the  neccessary  reset 
pulses  to  all  circuits  during  power  up  and  reset  operations  R25 
and  C2 1 4  provide  a  time  constant  which  holds  the  input  of  U 1 2 1 
low  during  power-up  This  allows  power  to  be  stable  to  all  cir- 
cuits before  the  RESET*  and  RESET  signals  are  applied  When 
C214  charges  to  a  logic  high,  the  output  of  U121  triggers  the 
input  of  a  retnggerable  one-shot  multivibrator  (U1 )  U1  outputs 
a  pulse  with  an  approximate  width  of  70  microsecs  When  the 
reset  switch  is  pressed  on  the  front  panel,  this  discharges  C21 4 
and  holds  the  input  of  U1 21  low  until  the  switch  is  released  On 
release  of  the  switch,  C214  again  charges  up  triggering  U121 
and  U1  to  reset  the  microcomputer  Another  signal  POWRST" 
is  generated  to  clear  drive  select  circuit  immediately  when 
reset  switch  is  pressed 

4.2.3  CPU 

The  central  processing  unit  (CPU)  of  the  Model  4P  microcom- 
puter is  a  Z80A  microprocessor  The  Z80A  is  capable  of  run- 
ning in  either  2  MHz  or  4  MHz  mode  The  CPU  controls  all 
functions  of  the  microcomputer  through  use  of  its  address  lines 
(A0-A15),  data  lines  (D0-D7),  and  control  lines  ('Ml,  IOREQ 
RD,  WR,  'MREQ,  and  /RFSH)  The  address  lines  (A0-A15) 
are  buffered  to  other  ICs  through  two  74LS244S  (U67  and  U27) 
which  are  enabled  all  the  time  with  their  enables  pulled  to  GNO 
The  control  lines  are  buffered  to  other  ICs  through  a  74F04 
(U87)  The  data  lines  (D0-D7)  are  buffered  through  a  bi-direc- 
tional 74LS245  (U86)  which  is  enabled  by  BUSEN"  and  the  di- 
rection is  controlled  by  BUSDIR* 

4.2.4  System  Timing 

The  main  timing  reference  of  the  microcomputer,  with  the 
exception  of  the  FDC  circuit,  is  generated  by  a  Gate  Array 
U148  and  a  20  2752  MHz  Crystal  This  reference  is  inter- 
nally divided  in  the  Gate  Array  to  generate  all  necessary  tim- 
ing for  the  CPU,  video  circuit,  and  RS-232-C  circuit  The 
CPU  clock  is  generated  U148  which  can  be  either  2  or 
4MHz  depending  on  the  logic  state  of  FAST  input  (pin  6  of 
U148)  If  FAST  is  a  logic  low,  the  U148  generates  a  2  02752 
MHz  clock  If  FAST  is  a  logic  high  U148  generates  a 
4  05504  MHz  signal  PCLK  (pin  23  of  U148)  is  filtered 
through  a  lernte  bead  (FB2)  and  22i!  Resistor  (R9)  and  then 


fed  to  the  CPU  U45  PCLK  is  generated  as  a  symmetrical 
clock  and  is  never  allowed  to  be  short  cycled  (eg  )  Not  al- 
lowed to  generate  a  low  or  high  pulse  under  110 
nanoseconds 

4.2.4.1  Video  Timing 

The  video  timing  is  also  generated  by  U 148  with  the  help  of  a 
PLL  Multiplier  Module  (PMM)  U1 46  These  two  ICs  generate  all 
the  necessary  timing  signals  for  the  four  video  modes  64  x  1 6, 
32  x  1 6  80  x  24  and  40  x  24  Two  reference  clocks  are  required 
for  the  four  video  modes  One  reference  clock  is  10  1376  MHz 
It  is  generated  internal  ly  to  U 1 48 ,  and  is  used  by  the  64  x  1 6  and 
32  x  1 6  modes  The  second  reference  clock  is  a  1 2  672  MHz 
(12M)  clock  which  is  generated  by  the  PMM  U146  12M  clock 
is  used  by  the  80  x  24  and  40  x  24  modes  A  1  2672  MHz 
(1  2M16)  signal  is  output  from  pin  3  of  U148  and  is  generated 
from  the  master  reference  clock,  the  20  2752  MHz  crystal 
1  2M16  is  used  for  a  reference  clock  for  the  PMM  The  PMM  is 
internally  set  to  oscillate  at  12  672  MHz  which  is  output  as  12M 
U148  divides  12M  by  10  to  generate  a  second  1  2672  MHz 
clock  (1  2M10)  which  is  fed  into  pin  5  of  U 146  (PMM)  The  two 
1  2672  MHz  signals  are  internally  compared  in  the  PMM  where 
it  corrects  the  1 2  672  MHz  output  so  it  is  synchronized  with  the 
20  2752  MHz  clock 

MODSEL  and  8064'  signals  are  used  lo  select  the  desired 
video  mode  8064"  controls  which  reference  clock  is  used  by 
U127  and  MODSEL  controls  the  single  or  double  character 
width  mode  Refer  to  the  following  chart  for  selecting  each 
video  mode 


8064* 

MODSEL 

Video  Mode 

0 

0 

64  x  16 

0 

1 

32  x  16 

1 

0 

80x24 

1 

1 

40x24 

'This  is  the  state  to  be  written  to  latch  U85  Signal  is  inverted 
before  being  input  to  U 148 
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DCLK  the  reference  clock  selected  is  output  from  U148 
U148  generates  SHIFT  XADR7'  CRTCLK  LOADS'  and 
LOAD*  for  proper  timing  tor  the  four  video  modes  U149  also 
generated  H  I  and  J  which  are  led  to  the  Graphics  Port  J7 
for  reference  timings  of  Hires  graphics  video  Refer  to  Video 
Timing  Figs  4-2  and  4-3  for  timing  reference 

4.2.5  Address  Decode 

The  Address  Decode  section  will  be  divided  into  two  subsec 
lions  Memory  Map  decoding  and  Port  Map  decoding 

4.2.5.1  Memory  Map  Decoding 

Memory  Map  Decoding  is  accomplished  by  Gate  Array  4  2 
(U106)  Four  memory  map  modes  are  available  which  are  com 
patible  with  the  Model  III  and  Model  4  microcomputers  U106  is 
used  for  memory  map  control  which  also  controls  page  map 
ping  of  the  32K  RAM  pages  Refer  to  Memory  Maps  below 

4.2.5.2  Port  Map  Decoding 

Port  Map  Decoding  is  accomplished  by  Gate  Array  4  2  (U106) 
U106  decodes  the  low  order  address  (AO  A7)  from  the  CPU 
and  decodes  the  port  being  selected  The  IN*  signal  allows  the 
CPU  to  read  from  a  selected  port  and  the  OUT*  signal  allows 
fhe  CPU  to  write  to  the  selected  port  Refer  to  IO  Port 
Assignment 

4.2.6  ROM 

The  Mode!  4P  contains  only  a  4K  x  8  Boot  ROM  (U70)  This 
ROM  is  used  only  to  boot  up  a  Disk  Operating  System  into 
the  RAM  memory  If  Model  III  operation  or  DOS  is  required 
then  the  RAM  from  location  0000-37FFH  must  be  loaded 
with  an  image  of  the  Model  III  or  4  ROM  code  and  then  exe 
cuted  A  file  called  MODEL  A/Ill  is  supplied  with  the  Model 
4P  which  contains  the  ROM  image  for  proper  Model  III  oper- 
ation On  power-up,  the  Boot  ROM  is  selected  and  mapped 
into  location  0000-OFFFH  After  the  Boot  Sector  or  the  ROM 
Image  is  loaded,  the  Boot  ROM  must  be  mapped  out  by 
OUTing  to  port  9CH  with  DO  set  or  by  selecting  Memory 
Map  modes  2  or  3  In  Mode  1  the  RAM  is  write  enabled  for 
the  full  14K  This  allows  the  RAM  area  mapped  where  Boot 
ROM  is  located  to  be  written  to  while  executing  out  of  the 
Boot  ROM  Refer  to  Memory  Maps 

The  Model  4P  Boot  ROM  contains  all  the  code  necessary  to 
initialize  hardware  detect  options  selected  from  the  keyboard 
read  a  sector  from  a  hard  disk  or  floppy  and  load  a  copy  of  the 
Model  III  ROM  Image  (as  mentioned)  into  the  lower  14K  of 
RAM 


The  firmware  is  divided  into  the  following  routines 

*  Hardware  Initialization 
"     Keyboard  Scanner 

'  Control 

*  Floppy  and  Hard*  Disk  Driver 

*  Disk  Directory  Searcher 
"  File  Loader 

*  Error  Handler  and  Displayer 
'  RS  232  Boot 

*  Diagnostic  Package 

Theory  of  Operation 

This  section  describes  the  operation  of  various  routines  in  the 
ROM  Normally  the  ROM  is  not  addressable  by  normal  use 
However  there  are  several  routines  that  are  available  through 
fixed  calling  locations  and  these  may  be  used  by  operating  sys 
terns  that  are  booting 

On  a  power  up  or  RESET  condition  the  Z80  s  program  counter 
is  set  to  address  0  and  the  boot  ROM  is  switched  in  The  mem 
ory  map  of  the  system  is  set  to  Mode  0  (See  Memory  Map  for 
details  )  This  will  cause  the  Z80  to  fetch  instructions  from  the 
boot  ROM 

The  Initialization  section  of  the  Boot  ROM  now  performs  these 
functions 

1  Disables  maskable  and  non  maskable  interrupts 

2  Interrupt  mode  1  is  selected 

3  Programs  the  CRT  Controller 

4  Initializes  the  boot  ROM  control  areas  in  RAM 

5  Sets  up  a  stack  pointer 

6  Issues  a  Force  Interrupt  to  the  Floppy  Disk  Controller 
to  abort  any  current  activity 

7  Sets  the  system  clock  to  4mhz 

8  Sets  the  screen  to  64  x  1 6 

9  Disables  reverse  video  and  ihe  alternate  character 
sets 

10  Tests  for  key  being  pressed* 

1 1  Clears  all  2K  of  video  memory 

*  This  is  a  special  test  If  the  is  being  pressed  then 
control  is  transferred  to  the  diagnostic  package  in  the 
ROM  All  other  keys  are  scanned  via  the  Keyboard 
Scanner 
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The  Keyboard  scanner  is  now  called.  11  scans  ihe  keyboard  for 
a  set  period  of  time  and  returns  several  parameters  based  on 
which,  if  any,  keys  were  pressed. 

The  keyboard  scanner  checks  for  several  different  groups  of 
keys.  These  are  shown  below: 


Function  Group 

<F1> 

<F2> 

<F3> 

<1> 

<2> 

<3> 

<Left-Shift> 

<  Right-Shift  > 

<Ctfl> 

<Caps> 


Selection  Group 

A 
B 
C 
D 

E 
F 
G 


<L>  Instructs  the  Control  routine  to 

load  the  Model  III  ROM-image, 
even  if  it  is  already  loaded  This 
is  useful  if  the  ROM-image  has 
been  corrupted  or  when  switch- 
ing ROM-images.  (Note  that 
this  will  not  cause  the  ROM- 
image  to  be  loaded  if  the  boot 
sector  check  indicates  that  the 
Model  III  ROM  image  is  not 
needed.  Press  ■  F3  -  or  •  F3  ■ 
and  ■  L  ■  to  accomplish  that. 

The  Selection  group  keys  are  used  in  determining  which  file  will 
be  read  from  disk  when  the  ROM-image  is  loaded.  For  details 
of  this  operation,  see  the  Disk  Directory  Searcher.  If  more  than 
one  of  the  Selection  group  keys  are  pressed,  the  last  one  de- 
tected will  be  the  one  that  is  used. 


• 


Special  Keys 
<P> 
<L> 
<N> 


Misc  Keys 

<Enter> 
<Break> 


When  any  key  in  the  Function  Group  is  pressed,  it  is  recorded 
in  RAM  and  will  be  used  by  the  Control  routine  in  directing  the 
action  of  the  boot.  If  more  than  one  of  these  keys  are  pressed 
during  the  keyboard  scan,  the  last  one  detected  will  be  the  one 
that  is  used.  The  Function  group  keys  are  currently  defined  as: 


<F1>  or  <1> 
<F2>  or  <2> 
<F3>  or  <3> 
<  Left-Shift  > 
<Right-Shift> 
<Ctrl> 
<Caps> 


Will  cause  hard  disk  boot 
Will  cause  floppy  disk  boot 
Will  force  Model  III  mode 
Reserved  for  future  use 
Boot  from  RS-232  port 
Reserved  (or  future  use 
Reserved  for  future  use 


The  Miscellaneous  keys  are: 


<  Break  > 


<Enter> 


Pressing  this  key  is  simply  re- 
corded by  setting  location 
405BH  non-zero  It  is  up  to  an 
operating  system  to  use  this 
flag  if  desired 

Terminates  the  Keyboard  rou- 
tine. Any  other  keys  pressed  up 
to  that  time  will  be  acted  upon. 
<  Enter >  is  useful  for  experi- 
enced users  who  do  not  want  to 
wait  until  the  keyboard  timer 
expires. 


The  Control  section  now  takes  over  and  follows  the  following 
flowchart. 


o 


The  Special  keys  are  commands  to  the  Control  routine  which 
direct  handling  of  the  Model  III  ROM-image.  Each  key  is  de- 
tected individually. 


<P> 


<N> 


When  loading  the  Model  III 
ROM-image,  the  user  will  be 
prompted  when  the  disks  can 
be  switched  or  when  ROM 
BASIC  can  be  entered  by 
pressing  <  Break  >. 
Instructs  the  Control  routine  to 
not  load  the  Model  III  ROM- 
image,  even  if  it  appears  thai 
Ihe  operating  system  being 
booted  requires  it. 
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At  this  point,  no  valid  Function  keys 
jj0  have  been  pressed. 
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Notes: 

(1 )  If  the  boot  sector  was  not  256  bytes  in  length  then  it  is  as- 
sumed to  be  a  Model  III  package  and  the  ROM  image  will 
be  needed  If  the  sector  is  256  bytes  in  length  then  the 
sector  is  scanned  for  the  sequence  CDxxOOH  The  CD  is 
the  first  byte  of  a  Z80  unconditional  subroutine  call  The 
next  byte  can  have  any  value  The  third  byte  is  tested 
against  a  zero  What  this  check  does  is  test  for  any  refer- 
ences to  the  first  256  bytes  of  memory  All  Radio  Shack 
Model  III  operating  systems  and  many  other  packages  all 
reference  the  ROM  at  some  point  during  the  boot  sector 
Most  boot  sectors  will  display  a  message  if  the  system  can- 
not be  loaded  To  save  space  these  routines  use  the 
Model  (If  ROM  calls  to  display  (he  message  Several  ROM 
calls  have  their  entry  points  in  the  first  256  bytes  of  mem- 
ory and  these  references  are  detected  by  the  boot  ROM 


Packages  thai  do  not  reference  the  Model  III  ROM  in  the 
boot  sector  can  still  cause  the  Model  III  ROM  image  to  be 
loaded  by  coding  a  CDxxOO  somewhere  in  the  boot  sector 
It  does  not  have  to  be  executable  At  the  same  time  Model 
4  packages  must  take  care  that  there  is  no  sequence  of 
bytes  in  the  boot  sector  that  could  be  mis-interpreted  to  be 
a  reference  to  the  Boot  ROM  An  example  of  this  would  be 
sequence  06CD0E00  which  is  a  LD  B  OCDH  and  a  LD 
C  0  If  the  boot  sector  cannot  be  changed  then  the  user 
must  press  the  F3  key  each  time  the  system  is  started 
to  inform  the  ROM  that  the  disk  contains  a  Model  III  pack- 
age which  needs  the  Model  III  ROM  image 

{2)  If  you  are  loading  a  Model  4  operating  system  then  the 
boot  ROM  will  always  transfer  control  to  the  first  byte  of  the 
boot  sector,  which  is  at  4300  H  If  you  are  loading  a  Model 
III  operating  system  or  about  to  use  Model  III  ROM  BASIC 
then  the  transfer  address  is  301 5H  This  is  the  address  of 
a  jump  vector  in  the  C  ROM  of  the  Model  III  ROM  image 
and  this  will  cause  the  system  to  behave  exactly  like  a 
Model  111  If  the  ROM  image  file  that  is  loaded  has  a  differ- 
ent transfer  address  then  that  address  will  be  used  when 
loading  is  complete  If  the  image  is  already  present,  the 
Boot  ROM  will  use  301 5H 

(3)  Two  different  tests  are  done  to  insure  that  the  Model  III 
ROM  image  is  present  The  first  test  is  to  check  every  third 
location  starting  at  3000H  for  a  C3H  This  is  done  for  1 0  lo- 
cations If  any  of  these  locations  does  not  contain  a  C3H 
then  the  ROM  image  is  considered  to  be  not  present 
The  next  lest  is  to  check  two  bytes  at  location  O00BH  If 
these  addresses  contain  E9E1H  then  the  ROM  image  is 
considered  to  be   present 

(4)  See  Disk  Director  Searcher  for  more  information 

(5)  See  File  Loader  for  more  information 

(6)  The  RS-232  loader  is  described  under  RS-232  Boot 

Disk  Directory  Searcher 

When  the  Model  Ml  ROM  image  is  to  be  loaded  it  is  always  read 
from  the  floppy  in  drive  0 

Before  (he  operation  begins,  some  checks  are  made  First  the 
boot  sector  is  read  in  from  the  floppy  and  the  first  byte  is 
checked  to  make  sure  it  is  either  a  00H  or  a  FEH  If  the  byte 
contains  some  other  value  no  attempt  will  be  made  to  read  the 
ROM  image  from  thai  disk  The  location  of  the  directory  cylinder 
is  then  taken  from  the  boot  sector  and  the  type  of  disk  is  deter- 
mined This  is  done  by  examining  the  Data  Address  Mark  that 


o 
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was  picked  up  by  the  Floppy  Disk  Controller  (FDC)  during  the 
read  of  the  sector  If  the  DAM  equals  1  the  disk  is  a  TRSDOS 
1  x  style  disk  If  the  DAM  equals  0  then  the  disk  is  a  LDOS  5  1 
TRSDOS  6  style  disk  This  is  important  since  TRSDOS  1  x 
disks  number  sectors  starting  with  1  and  LDOS  style  disks 
number  sectors  starting  with  0 

Once  the  disk  type  has  been  determined  an  extra  test  is  made 
if  the  disk  is  a  LDOS  style  disk  This  test  reads  the  Granule  Al 
location  Table  (GAT)  to  determine  if  the  disk  is  single  sided  or 
double  sided 


Floppy  and  Hard  Disk  Driver 

The  disk  drivers  are  entered  via  RST  8H  and  will  read  a  sector 
anywhere  on  a  floppy  disk  and  anywhere  on  head  1  (top  head) 
in  a  hard  disk  drive  Either  256  or  51 2  byte  sectors  are  readable 
by  these  routines  and  they  make  the  determination  of  the  sector 
size  The  hard  disk  driver  is  compatible  wilh  both  1he  WD1000 
and  the  WD1 010  controllers  The  floppy  disk  driver  is  written  for 
the  WD  1793  controller 

Serial  Loader 


The  directory  is  then  read  one  record  at  a  time  and  a  compare 
is  made  against  the  pattern  MODEL°o  for  the  filename  and 
III  for  the  extension  The  %  means  that  any  character  will 
match  this  position  If  the  user  pressed  one  of  the  selection 
keys  (A  G)  during  the  keyboard  scan  then  that  character  is 
substituted  in  place  of  the  %  character  For  example  if  you 
pressed  D  then  the  search  would  be  for  the  file  MODELD 
with  the  extension  III  The  searching  algorithm  searches  until 
it  finds  the  entry  or  it  reaches  the  end  of  the  directory 

Once  the  entry  has  been  found  the  extent  information  for  that 
file  is  copied  into  a  control  block  for  later  use 

File  Loader 

The  file  loader  is  actually  two  modules  —  the  actual  loader  and 
a  set  of  routines  to  (etch  bytes  from  the  file  on  disk  The  loader 
is  invoked  via  a  RST  28H  The  byte  (etcher  is  called  by  (he 
loader  using  RST  20H  Since  restart  vectors  can  be  re  directed 
the  same  loader  is  used  by  the  RS  232  boot  The  difference  is 
that  the  RST  20H  is  redirected  to  point  to  the  RS  232  data  re 
ceiving  routine  The  loader  reads  standard  loader  records  and 
acts  upon  two  types 

01  Data  Load 

1  byte  with  length  of  block  including  address 

1  word  with  address  to  load  the  data 

n  bytes  of  data  where  n  +  2  equals  the  length  specified 

02  Transfer  Address 

1  byte  with  the  value  of  02 

1  word  with  the  address  to  start  execution  at 

Any  other  loader  code  is  treated  as  a  comment  block  and  is  ig 
nored  Once  an  02  record  has  been  found  the  loader  stops 
reading  even  if  there  is  additional  data  so  be  sure  to  place  the 
02  record  at  the  end  of  the  file 


Invoking  (he  serial  loader  is  similar  to  forcing  a  boot  from  hard 
disk  or  floppy  In  this  case  the  right  shift  key  must  be  pressed  at 
some  time  during  (he  first  three  seconds  alter  reset  The  pro 
gram  does  not  care  i(  (he  key  is  pressed  forever  making  it  con 
venient  to  connect  pins  8  and  1 0o(  the  keyboard  connector  wilh 
a  shorting  plug  for  bench  testing  of  boards  This  assumes  tha! 
the  object  program  being  loaded  does  not  care  about  the  key 
closure 

Upon  entry  the  program  first  asserts  DTR  (J4  pin  20)  and  RTS 
(J4  pin  4)  true  Next  Not  Ready  is  pnnled  on  the  topmost  line 
of  the  video  display  Modem  status  line  CD  (J4  pin  8)  is  then 
sampled  The  program  loops  until  it  (mds  CD  asserted  true  Al 
that  time  the  message  Ready  is  displayed  Then  the  program 
sets  about  determining  the  baud  rate  from  (he  host  computer 

To  determine  (he  baud  rate  the  program  compares  data  re 
ceived  by  the  UART  to  a  test  byte  equal  to  55  hex  The  receiver 
is  first  set  to  1 9200  baud  )f  ten  bytes  are  received  which  are  not 
equal  to  the  test  byte  (he  baud  rate  is  reduced  This  sequence 
is  repeated  until  a  valid  test  byte  is  received  If  (en  failures  occur 
at  50  baud  the  entire  process  begins  again  at  19200  baud  tfa 
valid  test  byte  is  received  the  program  waits  for  (en  more  to  ar 
rive  before  concluding  that  it  has  determined  the  correct  baud 
rate  It  at  this  time  an  improper  byte  is  received  or  a  receiver  er 
ror  (overrun  framing  or  parity)  is  intercepted  the  task  begins 
again  at  19200  baud 

In  order  to  get  to  this  point  the  host  or  the  modem  must  assert 
CD  true  The  host  must  transmit  a  sequence  of  test  bytes  equal 
to  55  hex  with  8  data  bits  odd  parity  and  1  or  2  stop  bits  The 
test  bytes  should  be  separated  by  approximately  0  1  second  to 
avoid  overrun  errors 

When  the  program  has  determined  the  baud  rate  the  message 

Found  Baud  Rate  x 


is  displayed  on  the  screen  where    x   is  a  letter  from  A  to  P 
meaning 


A  =  50  baud  E  -  150 

B  =  75  F  =  300 

C  -  110  G  -  600 

D  =  134  5  H  =  1200 


I  =  1800 

M  - 

4800 

J  =  2000 

N  = 

7200 

K  =  2400 

o  - 

9600 

L  =  3600 

P  = 

19200 

Hardware  1 1 3 


The  same  message  less  the  character  signifying  the  baud  rate 
is  transmitted  to  the  host  with  the  same  baud  rate  and  protocol 
This  message  is  the  signal  to  the  host  to  stop  transmitting  test 
bytes 

Alter  the  program  has  transmitted  the  baud  rate  message  it 
reads  from  the  UART  data  register  in  order  to  clear  any  overrun 
error  that  may  have  occurred  due  to  the  test  bytes  coming  in 
during  the  transmission  of  the  message  This  is  because  the  re 
ceiver  must  be  made  ready  to  receive  a  sync  byte  signalling  the 
beginning  of  the  command  file  For  this  reason  it  is  important 
that  the  host  waif  until  the  entire  baud  rate  message  (16  char 
acters)  is  received  before  transmitting  the  sync  byte  which  is 
equal  lo  FF  hex 

When  the  loader  receives  the  sync  byte  the  message 

Loading 

is  displayed  on  the  screen  Again  the  same  message  is  trans 
mitted  to  the  host  and  again  the  host  must  wait  tor  the  entire 
transmission  before  starting  into  the  command  file 

If  the  receiver  should  intercept  a  receive  error  while  waiting  lor 
the  sync  byte  the  entire  operation  up  to  this  point  is  aborted 
The  video  display  is  cleared  and  the  message 


(Since  the  file  represents  Z80  machine  code  and  all  256 

combinations  are  meaningful  it  would  be  disastrous  to 
iransmit  nulls  or  other  ASCII  control  codes  as  fillers  ac- 
knowledgement or  start  stop  byles  The  only  control 
codes  needed  are  the  standard  command  file  control 
bytes ) 

Data  can  be  transmitted  lo  the  loader  at  1 9200  baud  with  no  de- 
lays inserted  Two  stop  bits  are  recommended  at  high  baud 
rates 

See  the  File  Loader  description  for  more  information  on  file 
loading 

If  a  receive  error  should  occur  during  file  loading  the  abort  pro- 
cedure described  above  will  take  place  so  when  attempting  re- 
mote control  it  is  wise  to  monitor  the  host  receiver  during 
transmission  of  the  file  When  the  host  is  near  the  ob|ect  board, 
as  is  the  case  in  the  factory  application  or  when  more  than  one 
board  is  being  loaded  it  may  be  advantageous  or  even  nec- 
essary to  ignore  the  transmitted  responses  of  the  object 
board(s)  and  lo  manually  pace  the  test  byte  sync  byte  and 
command  Me  phases  of  the  transmission  process  using  the 
video  display  for  handshaking 

System  Programmers  Information 


Error  x 

is  displayed  near  the  bottom  of  the  screen  where  x  is  a  letter 
from  B  to  H  meaning 

B  =  parity  error 

C  =  framing  error 

D  =  parity  &  framing  errors 

E  =  overrun  error 

F  =  parity  &  overrun  errors 

G  =  framing  &  overrun  errors 

H  =  parity  &  framing  &  overrun  errors 

The  message 

Error 

is  then  transmitted  to  the  host  The  entire  process  is  then  re 
peated  from  the  Not  Ready  message  A  six  second  delay  is 
inserted  before  reinitialization  This  is  longer  than  the  time  re 
quired  to  transmit  five  bytes  at  50  baud  so  there  is  no  need  to 
be  extra  careful  here 

If  the  sync  byle  is  received  without  error  then  the    Loading 
message  is  transmitted  and  the  program  is  ready  to  receive  the 
command  file  After  receiving  the   Loading   message  the  host 
can  transmit  the  lile  without  nulls  or  delays  between  bytes 


The  Model  4P  Boot  ROM  uses  two  areas  of  RAM  while  it  is  run- 
ning These  are  4000H  to  40FFH  and  4300H  to  43FFH  (For 
512  byle  boot  sectors  the  second  area  is  4300H  to  44FFH  )  If 
the  Model  III  ROM  Image  is  loaded  additional  areas  are  used 
See  the  technical  reference  manual  for  the  system  you  are  us- 
ing for  a  list  of  these  areas 

Operating  systems  that  want  to  support  a  software  restart  by  re- 
executmg  the  contents  of  the  boot  ROM  can  accomplish  this  in 
one  of  two  ways  If  the  operating  system  relies  on  the  Model  III 
ROM  Image  then  jump  to  location  0  as  you  have  in  the  past  II 
the  operating  system  is  a  Model  4  mode  package  a  simple  way 
is  to  code  the  following  instructions  in  your  assembly  and  load 
them  before  you  want  to  reset 


o 


Absolute  Location 

Instruction 

0000 

D! 

0001 

LD                A  1 

0003 

OUT             (9CH)  A 

These  instructions  cause  the  boot  ROM  to  become  address- 
able Alter  executing  the  OUT  instruction  the  next  instruction 
executed  will  be  one  in  the  boot  ROM  (These  instructions  also 
exist  m  the  Model  III  ROM  image  at  location  0  )  The  boot  ROM 
has  been  written  so  that  the  first  instruction  is  at  address  0005 
The  hardware  must  be  in  memory  mode  0  or  1 ,  or  else  the 
boot  ROM  will  not  be  switched  in  This  operation  can  be 
done  with  an  OUT  instruction  and  then  a  RST  0  can  be  exe- 
cuted to  have  the  ROM  switched  in 
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Restarts  can  be  redirected  at  any  time  while  the  ROM  is 
switched  in  All  restarts  jump  to  fixed  locations  in  RAM  and 
these  areas  may  be  changed  to  point  to  the  routine  that  is  to  be 
executed 

Restart    RAM  Location     Default  Use 

Cold  Start  Boot 

Disk  I  O  Request 

Display  string 

Display  block 

Byte  Fetch  (Called  by  Loader) 

File  Loader 

Keyboard  scanner 

Reserved  for  future  use 

NMI  {Floppy  I'O  Command 

Complete) 


Display  String  (RST  10H) 


0 

none 

8 

4000H 

10 

4003H 

18 

4006H 

20 

4009H 

28 

400CH 

30 

400FH 

38 

401 2H 

66 

401 5H 

Accepts 
HL 

OE 


Returns 
Success  Always 

A 

OE 

HL 


Pointer  to  text  to  be  displayed 
Text  must  be  terminated  with  a  null  (0) 
Offset  position  on  screen  where  text  is  to 
be  displayed 

(A  0OOOH  will  be  the  upper  left-hand  cor- 
ner of  the  display  ) 


Altered 

Points  to  next  position  on  video 

Pomls  to  the  null  (0) 


Display  Block  (RST  18H) 


The  above  routines  have  fixed  entry  parameters  These  are  de- 
scribed here 

Disk  I/O  Request  (RST  8H) 


Accepts 
HL 


Points  to  control  vector  in  the  format 


Accepts 
A 

B 


^^^P 


OE 
HL 


Returns 
Z 
NZ 

Error  Codes 
3 
4 
5 
6 
7 

S 

9 
11 
12 


1  for  floppy,  2  for  hard  disk 
Command 
Initialize        1 
Restore         4 
Seek  6 

Read  12  (All  reads  have  an  im- 

plied seek) 
Sector  number  to  read 
The  contents  of  the  location  disktype 
(405CH)  are  added  to  this  value  before 
an  actual  read  If  the  disk  is  a  two  sided 
floppy,  just  add  18  to  the  sector  number 
Cylinder  number    (Only   E   is   used   in 
floppy  operations) 

Address  where  data  from  a  read  opera- 
tion is  to  be  stored 


Success,  Operation  Completed 
Error,  Error  code  in  A 


Hard  Disk  drive  is  not  ready 

Floppy  disk  drive  is  not  ready 

Hard  Disk  drive  is  not  available 

Floppy  disk  drive  is  not  available 

Drive  Not  Ready  and  no  Index  (Disk  in 

drive,  door  open) 

CRC  Error 

Seek  Error 

Lost  Data 

ID  Not  Found 


+  0 

Screen  Offset 

+  2 

Pointer  to  texl, 

terminated  with 

null 

+  4 

Pointer  to  text, 

terminated  with 

null 

-i-n 

word  FFFFH 

End  of  control 
vector 

or                   +n 

word  FFFEH 

Next  word  is 
new  Screen 
Offset 

If  Z  flag  is  set  on  entry  then  the  firsl  screen  offset  is  read  from 

DE  instead  of  from  the  control  vector 

Each  string  is  positioned  after  the  previous  string,  unless  a 
FFFEH  entry  is  found  This  is  used  heavily  in  the  ROM  to  re- 
duce duplication  of  words  in  error  messages 

Returns 
Success  Always 

DE  Points  to  next  position  on  video 

Byte  Fetch  (RST  20H) 


Accepts  None 
Returns 

Z 

NZ 


Errors 


2 
10 


Success,  byte  in  A 
Failure,  error  code  in  A 


Any  errors  from  the  disk  I'O  call  and 

ROM  Image  can't  be  loaded  —  Too  many 

extents 

ROM  Image  can't  be  loaded  —  Disk  drive 

is  not  ready 


Hardware  115 


File  Loader  (RST28H) 
Accepts  None 


Returns 
Z 
NZ 

Errors 


Success 

Failure,  error  code  in  A 


Any  errors  from  the  disk  i/O  call  or  the 
byte  fetch  call  and: 
0  The  ROM  image  was  not  found  on  drive  0 

There  are  several  pieces  of  information  left  in  memory  by  the 
boot  ROM  which  are  useful  to  system  programmers.  These  are 
shown  below: 


RAM  Location 
401 DH 

4055H 


4056H 
4057H 

4059H 


405BH 
405CH 


Description 

ROM  Image  Selected  (%  for  none 
selected  or  A-G) 
Boot  type 

1  =  Floppy 

2  =  Hard  disk 

3  =  ARCNET 

4  =  RS-232C 

5  -  7  =  Reserved 

Boot  Sector  Size  {1  for  256.  2  for  512) 

RS-232  Baud  Rate  (only  valid  on  RS- 

232  boot) 

Function  Key  Selected 

0  =  No  function  key  selected 


<F1>  or  <1> 

86 

<F2>  or  <2> 

87 

<F3>  or  <3> 

88 

<Caps> 

85 

<Ctrl> 

84 

<Left-Shift> 

82 

<  Right-Shift  > 

83 

Reserved 

80-81  and  89-90 

Break  Key  Indication  {non-zero  if 

<Break>  pressed) 

Disk  type  (0  for  LDOS/ 

TRSDOS6.1  for 
TRSDOS1.X) 


The  DRAMs  require  multiplexed  incoming  address  lines.  This 
is  accomplished  by  ICs  U110  and  U111  which  are  74LS157 
multiplexers.  Data  to  and  from  the  DRAMs  are  buffered  by  a 
74LS245  <U1 18)  which  is  controlled  by  Gate  Array  4.2  (U106). 
The  proper  timing  signals  RASO*.  RAS1 ' ,  MUX",  and  CAS'  are 
generated  by  a  delay  line  circuit  U94.  U116  (1  2  ol  a  74S1 12) 
and  U1 17  (1  4  of  a  74F08)  are  used  to  generate  a  precharge 
circuit.  During  M1  cycles  of  the  Z80A  in  4  MHz  mode,  the  high 
time  in  MREQ  has  a  minimum  time  of  1 1 0  nanosecs.  The  spec- 
ification of  6665  DRAM  requires  a  minimum  of  1 20  nanosecs  so 
this  circuit  will  shorten  the  MREO  signal  during  the  M1  cycle. 
The  resulting  signal  PMREQ  is  used  to  start  a  RAM  memory 
cycle  through  U1 14  (a  74S64).  Each  different  cycle  is  controlled 
at  U1 14  to  maintain  a  fast  M1  cycle  so  no  wait  states  are  re- 
quired. The  output  ol  U1 1 4  (PRAS*)  is  ANDed  with  RFSH  to  not 
allow  MUX*  and  CAS*  to  be  generated  during  a  REFRESH 
cycle.  PRAS*  also  generates  either  RASO*  or  RAS1  * ,  depend- 
ing on  which  bank  of  RAM  the  CPU  is  selecting.  GCAS*  gen- 
erated by  the  delay  line  U94  is  latched  by  U116  (1  2  of  a 
74S1 12)  and  held  to  the  end  of  the  memory  cycle.  The  output 
of  U1 1 6  is  ANDed  with  VIDEO  signal  to  disable  the  CAS*  signal 
from  occurring  if  the  cycle  is  a  video  memory  access.  Refer  to 
Ml  Cycle  Timing  (Figure  4-7  and  4-8),  Memory  Read  and 
Memory  Write  Cycle  Timing  (Figure  4-9)  and  (Figure  4-10). 


Keep  in  mind  that  Model  III  ROM  image  will  initialize  these 
areas,  so  this  information  is  useful  only  to  the  Model  4  mode 
programmer. 

4.2.7  RAM 

Two  configurations  of  Random  Access  Memory  (RAM)  are 
available  on  the  Model  4P:  64K  and  128K.  The  64K  and  128K 
option  use  the  6665-type  64K  x  1  200NS  Dynamic  RAM,  which 
requires  only  a  single  +  5v  supply  voltage. 
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Memory  Map  —  Model  4P 


ModeO 

SELO 

SEL1 
ROM 

-  0  -  OV 
0        OV 

-  1    -  OV 

Mode  1 

SELO    -  1         -5V 
SEL1     -  0        OV 
ROM     -0         -5V 

0000  —  OFFF 

Boot  ROM 

4K 

0000  — 

37FF 

RAM 

1 000  —  37FF 

RAM  (Read  Only) 

10K 

3800  — 

3BFF 

Keyboard 

37E8—  37E9 

Printer  Status  (Read  Only) 

2 

3CO0- 

-3FFF 

Video 

3800  —  3BFF 

Keyboard 

1K 

4000  — 

FFFF 

RAM 

3C00  —  3FFF 

Video 

1K 

4000  —  FFFF 

RAM 

48K 

Mode  2 

SELO    -  0    -  OV 
SEL1    =1    =   +5V 

ModeO 

SELO 
SEL1 

0    =  OV 
-  0   -  OV 

ROM    -  X  -  Don  t  Care 

ROM 

-  0    -    +  5V 

0000  — 
F400  — 

F3FF 
F7FF 

RAM 
Keyboard 

0000  — 3  7FF 

RAM  (Read  Only) 

14K 

F800  — 

FFFF 

Video 

37E8  —  37E9 

Printer  Status  (Read  Only) 

2 

3800  —  3BFF 

Keyboard 

1K 

3C00  —  3FFF 

Video 

1K 

Mode  3 

SELO    -  1    -   +5V 

4000  — FFFF 

RAM 

48K 

SEL1     =1    =   +5V 
ROM    =  X  =  Don  t  Care 

Model 

SELO 
SEL1 
ROM 

=  1    =   +5V 
=  0   =  OV 
=  1    =  OV 

0000  — 

FFFF 

RAM 

0000  —  OFFF 

Boot  ROM 

4K 

0000  —  OFFF 

RAM  (Write  Only) 

4K 

1000  — 37FF 

RAM 

10K 

3800  —  3BFF 

Keyboard 

1K 

3C00  —  3FFF 

Video 

IK 

4000  —  FFFF 

RAM 

48K 

14K 
1K 
1K 

48K 


61K 
1K 
2K 


64K 


o 
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I/O  Port  Assignment 


Normally 

r 

Port# 

Used 

Out 

In 

FC  — FF 

FF 

CASSOUT  * 

MODIN  * 

F8  —  FB 

F8 

LPOUT • 

LPIN' 

F4— F7 

F4 

DRVSEL  * 

(RESERVED) 

FO  —  F3 

- 

DISKOUT  • 

DISKIN  • 

FO 

FO 

FDC  COMMAND  REG. 

FDC  STATUS  REG. 

F1 

F1 

FDC  TRACK  REG. 

FDC  TRACK  REG. 

F2 

F2 

FDC  SECTOR  REG. 

FDC  SECTOR  REG. 

F3 

F3 

FDC  DATA  REG. 

FDC  DATA  REG 

EC— EF 

EC 

MODOUT  * 

RTCIN  ■ 

E8—  EB 

- 

RS2320UT  * 

RS232IN  * 

E8 

E8 

UART  MASTER  RESET 

MODEM  STATUS 

E9 

E9 

BAUD  RATE  GEN.  REG. 

(RESERVED) 

EA 

EA 

UART  CONTROL  AND 
MODEM  CONTROL  REG 

UART  STATUS  REG. 

EB 

EB 

UART  TRANSMIT 

UART  HOLDING  REG 

HOLDING  REG 

(RESET  DR.) 

E4  — E7 

E4 

WR  NMI  MASK  REG.  ' 

hD  NMI  STATUS  - 

EO  — E3 

EO 

WR  INT  MASK  REG.  * 

RD  INT  MASK  REG.  * 

AO  — DF 

- 

(RESERVED) 

(RESERVED) 

9C  — 9F 

9C 

BOOT- 

(RESERVED) 

94  —  9B 

- 

(RESERVED) 

(RESERVED) 

90  —  93 

90 

SEN' 

(RESERVED) 

8C  — 8F 

- 

GSELO  * 

GSELO ' 

88  —  8B 

- 

CRTCCS  * 

(RESERVED) 

88,  8A 

88 

CRCT  ADD.  REG. 

(RESERVED) 

89,  8B 

89 

CRCT  DATA  REG. 

(RESERVED) 

84  —  87 

84 

OPREG  * 

(RESERVED) 

80  —  83 

- 

GSEL1  • 

GSEL1  * 
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I/O  Port  Description 

Name:  CASSOUT - 

Port  Address:   FC  —  FF 
Access:  WRITE  ONLY 

Description:      Oulput  data  to  cassette  or  for  sound 
generation 

Note:      The  Model  4P  does  not  support  cassette  storage 
this  port  is  only  used  lo  generate  sound  that  was  to 
be  output  via  cassette  port  The  Model  4P  sends 
data  to  onboard  sound  circurt 

DO  =  Cassette  output  level  (sound  data  output) 

D1  =  Reserved 

D2  — D7      =  Undefined 


Name:  MODIN  *  (CASSIN  *) 

Port  Address:  FC  — FF 

Access:  READ  ONLY 

Description:  Configuration  Status 


DO 

=  0 

D1 

-  CASSMOTORON  STATUS 

D2 

=  MODSEL  STATUS 

D3 

=  ENALTSET  STATUS 

D4 

=  ENEXTIO  STATUS 

OS 

=  (NOT  USED) 

06 

=  FAST  STATUS 

D7 

=  0 

Name:  LPOUT  * 

Port  Address:  F8  —  FB 

Access:  WRITE  ONLY 

Description:  Output  data  to  line  printer 


DO  — D7 


ASCII  BYTE  TO  BE  PRINTED 


Name:  LPIN  * 

Port  Address:  FB— FB 

Access:  READ  ONLY 

Description:  Input  line  printer  status 


DO  —  D3 


D4 


DS 


08 


D7 


-  (RESERVED) 

-  FAULT 

1  -  TRUE 

0  -  FALSE 

=  UNIT  SELECT 

1  =  TRUE 

0  =  FALSE 

=  OUTPAPER 

1  =  TRUE 

0  -  FALSE 

=  BUSY 

1  =  TRUE 
0  -  FALSE 


Name:  DRVSEL ' 

Port  Address:  F4  —  F7 

Access:  WRITE  ONLY 

Description:  Output  FDC  Configuration 

Note:      Output  to  this  port  will  ALWAYS  cause  a  1  -2  msec 
(Microsecond)  wait  to  the  Z80 


DO 

-=  DRIVE  SELECT  0 

D1 

=  DRIVE  SELECT  1 

02 

=  (RESERVED) 

03 

=  (RESERVED) 

04 

=  SDSEL 

0  =  SIDE  0 

1  =  SIDE  1 

o 


05  =  PRECOMPEN 

0  =  No  write  precompensation 

1  =  Write  Precompensation  enabled 

06  =  WSGEN 

0  =  No  wait  state  generated 

1  =  wait  state  generated 

Note:      This  wait  state  is  to  sync  Z80  with  FDC  chip  during 
FDC  operation 

D7  -  DDEN  * 

0  =  Single  Density  enabled  (FM) 

1  =  Double  Density  enabled  (MFM) 
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Name:  DISKOUT  * 

Port  Address:   F0—F3 

Access:  WRITE  ONLY 

Description:      Output  to  FDC  Control  Registers 

Port  FO  =  FDC  Command  Register 

Port  F1   -  FDC  Track  Register 

Port  F2  =  FDC  Sector  Register 

Port  F3  =  FDC  Data  Register 

(Refer  to  FDC  Manual  for  Bit  Assignments) 

Name:  DISKIN  * 

Port  Address:   FO  — F3 

Access:  READ  ONLY 

Description:      Input  FDC  Control  Registers 

Port  FO  =  FDC  Status  Register 

Port  F1  =  FDC  Track  Register 

Port  F2  =  FDC  Sector  Register 

Port  F3  =  FDC  Data  Register 

(Refer  to  FDC  Manual  for  Bit  Assignment) 


Name:  MODOUT  * 

Port  Address:  EC  — EF 

Access:  WRITE  ONLY 

Description:  Output  to  Configuration  Latch 

DO  =  (RESERVED) 

D1  =  CASSMOTORON  (Sound  enable) 

0  =  Cassette  Motor  Off  (Sound  enabled) 

1  =  Cassette  Motor  On  (Sound  disabled) 

D2  =  MODSEL 

0  =  64  or  80  character  mode 

1  =  32  or  40  character  mode 

D3  =  ENALTSET 

0  =  Alternate  character  set  disabled 

1  =  Alternate  character  set  enabled 


D4 

-  ENEXTIO 

0  -  External  10  Bus  disabled 

1  -  External  IO  Bus  enabled 

D5 

- (RESERVED) 

D6 

-  FAST 

0-2  MHZ  Mode 

1  -  4  MHZ  Mode 

D7 

=  (RESERVED) 

Name:  RTCIN - 

Port  Address:  EC— EF 

Access:  READ  ONLY 

Description:  Clear  Real  Time  Clock  Interrupt 


DO  —  D7 


DON  T  CARE 


Name:  RS2320UT  * 

Port  Address:   E8  —  EB 
Access:  WRITE  ONLY 

Description:      UART  Control,  Data  Control,  Modem  Control 
BRG  Control 

Port  E8  =  UART  Master  Reset 

Port  E9  =  BAUD  Rate  Gen  Register 

Port  EA  =  UART  Control  Register  (Modem  Control  Reg  ) 

Port  EB  =  UART  Transmit  Holding  Reg 

(Refer  to  Model  III  or  4  Manual  for  Bit  Assignments) 

Name:  RS232IN  * 

Port  Address:  E8  — EB 

Access:  READ  ONLY 

Description:  Input  UART  and  Modem  Status 

Port  E8  =  MODEM  STATUS 

Port  E9  =  (RESERVED) 

Port  EA  =  UART  Status  Register 

Port  EB  =  UART  Receive  Holding  Register  (Resets  DR) 

(Refer  to  Model  III  or  4  Manual  for  Bit  Assignments) 
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Name:  WRNMIMASKREG 

Port  Address:  E4— E7 

Access:  WRITE  ONLY 

Description:  Output  NMI  Latch 


D0- 

-D5 

(RESERVED) 

D6 

-  ENMOTOROFFINT 

0  Disables  Motoroff  NMI 

1  -  Enables  Motorotf  NMI 

D7  -  ENINTRQ 

0  -  Disables  INTRQ  NMI 

1  -  Enables  INTRQ  NMI 


D5 


D6 


D7 


ENRECINT 

0  RS232  Rec  Data  Reg  full  int  disabled 

1  -  RS232  Rec  Data  Reg  full  mt  enabled 

ENERRORINT 

0  -  RS232  UART  Error  interrupts  disabled 

1  -  RS232  UART  Error  interrupts  enabled 

(RESERVED) 


Name:  RDINTSTATUS ' 

Port  Address:  EO—  E3 

Access:  READ  ONLY 

Description:  Input  INT  Status 


Name:  RDNMISTATUS ' 

Port  Address:  E4  —  E7 

Access:  READ  ONLY 

Description:  Input  NMI  Status 


DO 


=  0 


D2- 

-D4 

-  (RESERVED) 

DS 

=■  RESET  (not  needed) 

0  ~  Reset  Asserted  (Problem) 

1  -  Reset  Negated 

D6  =•  MOTOROFF 

0  -  Motoroff  Asserted 

1  -  Motoroff  Negated 

D7  =  INTRQ 

0  -  INTRQ  Asserted 

1  =  INTRQ  Negated 


Name:  WRINTMASKREG  * 

Port  Address:   EO  —  E3 
Access:  WRITE  ONLY 

Description:      Output  INT  Latch 

DO— D1       =  (RESERVED) 

02  =  ENRTC 

0  =  Real  time  clock  interrupt  disabled 

1  -  Real  time  clock  interrupt  enabled 

03  =  ENIOBUSINT 

0  =  External  10  Bus  interrupt  disabled 

1  =  External  IO  Bus  interrupt  enabled 


DO- 

-D1 

-  (RESERVED) 

D2 

-  RTC  INT 

D3 

-  lOBUS  INT 

D4 

=  RS232  XMIT  INT 

D5 

=  RS232  REC  INT 

D6 

=  RS232  UART  ERROR  INT 

D7 

-  (RESERVED) 

Name:  BOOT ' 

Port  Address:  9C  —  9F 

Access:  WRITE  ONLY 

Description:  Enable  or  Disable  Boot  ROM 

DO  =  ROM  ' 

0  -  Boot  ROM  Disabled 

1  =  Bool  ROM  Enabled 

D1 —  D7      =  (RESERVED) 


Name:  SEN  - 

Port  Address:  90  —  93 
Access:  WRITE  ONLY 

Description:      Sound  output 

DO  =  SOUND  DATA 

D1 —  D7      =  (RESERVED) 


o 


04 


ENXMITINT 

0  =    RS232   Xmit   Holding   Reg    empty  int 
disabled 

1  =    RS232   Xmit   Holding    Reg    empty   int 
enabled 
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Name: 

Port  Address: 

Access: 

Description: 


OPREG  * 

84 

WRITE  ONLY 

Output  to  operation  reg. 


DO 


SELO 


D1 


SEL1 


02 


SEL1 

SELO 

MODE 

0 

0 

0 

0 

1 

1 

1 

0 

2 

1 

1 

3 

8064 

0  = 

=  64  character  mode 

1  = 

=  80  character  mode 

D3 


INVERSE 

0  =  Inverse  video  disabled 

1  =  Inverse  video  enabled 


J 


D4  =  SRCPAGE  —  Points  to  the  page  to  be  mapped 

as  new  page 

0  U64K,  L32K  Page 

1  =  U64K.  U32K  Page 

05  =  ENPAGE  —  Enables  mapping  of  new  page 

0  -  Page  mapping  disabled 

1  =  Page  mapping  enabled 

D6  =   DESPAGE  —  Points  to  the  page  where  new 

page  is  to  be  mapped; 

0  =  L64K,  U32K  Page 

1  =  L64K,  L32K  Page 


D7 


PAGE 

0  =  Page  0  of  Video  Memory 

1  =  Page  1  of  Video  Memory 
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4.2.8  Video  Circuit 

The  heart  of  the  video  display  circuit  in  the  Model  4P  is  the 
68045  Cathode  Ray  Tube  Controller  (CRTC)  U42  The  CRTC 
is  a  preprogrammed  video  controller  that  provides  two  screen 
formats  64  by  16  and  80  by  24  The  format  is  controlled  by  pin 
3  of  the  CRTC  (8064')  The  CRTC  generates  all  of  the  neces- 
sary signals  required  for  the  video  display  These  signals  are 
VSYNC  (Vertical  Sync),  HSYNC  (Horizontal  Sync)  for  proper 
sync  of  the  monitor  DISPEN  (Display  Enable)  which  indicates 
when  video  data  should  be  output  to  the  monitor,  the  refresh 
memory  addresses  (MA0-MA1 3)  which  addresses  the  video 
RAM,  and  the  row  addresses  (RA0-RA4)  which  indicates  which 
scan  line  row  is  being  displayed  The  CRTC  also  provides  hard- 
ware scrolling  by  writing  to  the  internal  Memory  Start  Address 
Register  by  OUTing  to  Port  88H  The  internal  cursor  control  of 
the  68045  is  not  used  in  the  Model  4P  video  circuit 

Since  the  80  by  24  screen  requires  1 ,920  screen  memory  lo- 
cations, a  2K  by  8  static  RAM  (U82)  is  used  for  the  video  RAM 
Addressing  to  the  video  RAM  (U82)  is  provided  by  the  68045 
when  refreshing  the  screen  and  by  the  CPU  when  updating  of 
the  data  is  performed  These  two  sets  of  address  lines  are  mul- 
tiplexed by  three  74LS157S  (U41,  U61,  and  U81)  The  multi- 
plexers are  switched  by  CRTCLK  which  allows  the  CRTC  to 
address  the  video  RAM  during  the  high  state  of  CRTCLK  and 
the  CPU  access  during  the  low  state  A1 0  from  the  CPU  is  con- 
trolled by  PAGE*  which  allows  two  display  pages  in  the  64  by 
1 6  format  When  updates  to  the  video  RAM  are  performed  by 
the  CPU,  the  CPU  is  held  in  a  WAIT  state  until  the  CRTC  is  not 
addressing  the  video  RAM  This  operation  allows  reads  and 
writes  to  video  RAM  without  causing  hashing  on  the  screen 
The  circuit  that  performs  this  function  is  a  74LS244  buffer 
(U84),  an  8  bit  transparent  latch,  74LS373  (U83)  and  a  Delay 
line  circuit  shared  with  Dynamic  RAM  timing  circuit  consisting 
Ot  a  74LS74  (U98),  74LS32  (U96),  74LS04  (U95),  74LS00 
(U92),  74LS02  (U69),  and  Delay  Line  (U94)  During  a  CPU 
Read  Access  to  the  Video  RAM.  the  address  is  decoded  by  the 
GA  4  2  and  asserts  VIDEO"  low  This  is  inverted  by  U95  ( 1  6  of 
74LS04)  which  pulls  one  input  of  U92  (1  4  of  74LSO0)  and  in 
turn  asserts  VWAIT  *  low  to  the  CPU  RD  is  high  at  this  time  and 
is  latched  into  U98  (1  2  of  74LS74)  on  the  rising  edge  of 
XADR7*.  inverse  of  CRTCLK 


When  RD  is  latched  by  U98  the  Q  output  goes  low  releasing 
WAIT*  from  the  CPU  The  same  signal  also  is  sent  to  the  Delay 
Line  (U94)  through  U1 1 7  (1  4  ol  74F08)  The  Delay  line  delays 
the  falling  edge  240  ns  for  VLATCH*  which  latches  the  read 
data  from  the  video  RAM  at  U83  The  data  is  latched  so  the 
CRTC  can  refresh  the  next  address  location  and  prevent  any 
hashing  MRD'  decoded  by  U106  and  a  memory  read  is  ORed 
with  VIDEO*  which  enables  the  data  from  U83 10  the  data  bus 
The  CPU  then  reads  the  data  and  completes  the  cycle  A  CPU 
write  is  slightly  more  complex  in  operation  As  in  the  RD  cycle, 
VIDEO*  is  asserted  low  which  asserts  VWAIT*  low  to  ihe  CPU 
WR  is  high  at  this  time  which  is  NANDed  with  VIDEO  and 
synced  with  CRTCLK  to  create  VRAMDIS  that  disables  the 
video  RAM  output  On  the  rising  edge  of  XADR7*.  WR  is 
latched  into  U98  ( 1  2  of  74LS74)  which  releases  VWAIT*  and 
starts  cycle  through  the  Delay  Line  After  30ns  DLYVWR*  (De- 
layed video  write)  is  asserted  low  which  also  asserts  VBUFEN* 
(Video  Buffer  Enable)  low  VBUFEN*  enabled  data  from  the 
Data  bus  to  the  video  RAM  Approximately  120ns  later 
DLYVWR*  is  negated  high  which  writes  the  data  to  the  video 
RAM  and  negates  VBUFEN*  turning  off  buffer  The  CPU  then 
completes  WR  cycle  to  the  video  RAM  Refer  to  Video  RAM 
CPU  Access  Timing  Figure  5-12  for  timing  of  above  RD  or  WR 
cycles 

During  screen  refresh,  CRTCLK  is  high  allowing  the  CRTC 
to  address  Video  RAM  The  data  out  of  the  video  RAM  is 
latched  by  LOAD*  into  Gate  Array  4  3  (U102)  INVERSE* 
determines  if  character  should  be  alpha-numeric  only  (IN- 
VERSE* high)  or  unchanged  (INVERSE*  low)  A9  is  de- 
coded with  ENALTSET  (Enable  Alternate  Set)  and  7,  which 
controls  the  alternate  set  in  the  character  generator  ROM 
See  ENALTSET  Control  Table  below 


ENALTSET 

Q7 

Q6 

A9 

0 

0 

0 

0 

0 

1 

0 

0 

0 

1 

1 

1 

1 

0 

0 

0 

1 

0 

1 

1 

1 

1 

0 

0 

1 

1 

1 

0 

o 
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4.2.8  Video  Circuit 

The  heart  of  the  video  display  circuit  in  the  Model  4P  is  the 
68045  Cathode  Ray  Tube  Controller  (CRTC)  U42  The  CRTC 
is  a  preprogrammed  video  controller  that  provides  two  screen 
formats  64  by  16  and  80  by  24  The  format  is  controlled  by  pin 
3  of  the  CRTC  (8064')  The  CRTC  generates  all  of  the  neces- 
sary signals  required  for  the  video  display  These  signals  are 
VSYNC  (Vertical  Sync),  HSYNC  (Horizontal  Sync)  for  proper 
sync  of  the  monitor  DISPEN  (Display  Enable)  which  indicates 
when  video  data  should  be  output  to  the  monitor,  the  refresh 
memory  addresses  (MA0-MA1 3)  which  addresses  the  video 
RAM,  and  the  row  addresses  (RA0-RA4)  which  indicates  which 
scan  line  row  is  being  displayed  The  CRTC  also  provides  hard- 
ware scrolling  by  writing  to  the  internal  Memory  Start  Address 
Register  by  OUTing  to  Port  88H  The  internal  cursor  control  of 
the  68045  is  not  used  in  the  Model  4P  video  circuit 

Since  the  80  by  24  screen  requires  1 ,920  screen  memory  lo- 
cations, a  2K  by  8  static  RAM  (U82)  is  used  for  the  video  RAM 
Addressing  to  the  video  RAM  (U82)  is  provided  by  the  68045 
when  refreshing  the  screen  and  by  the  CPU  when  updating  of 
the  data  is  performed  These  two  sets  of  address  lines  are  mul- 
tiplexed by  three  74LS157S  (U41,  U61,  and  U81)  The  multi- 
plexers are  switched  by  CRTCLK  which  allows  the  CRTC  to 
address  the  video  RAM  during  the  high  state  of  CRTCLK  and 
the  CPU  access  during  the  low  state  A1 0  from  the  CPU  is  con- 
trolled by  PAGE*  which  allows  two  display  pages  in  the  64  by 
1 6  format  When  updates  to  the  video  RAM  are  performed  by 
the  CPU,  the  CPU  is  held  in  a  WAIT  state  until  the  CRTC  is  not 
addressing  the  video  RAM  This  operation  allows  reads  and 
writes  to  video  RAM  without  causing  hashing  on  the  screen 
The  circuit  that  performs  this  function  is  a  74LS244  buffer 
(U84),  an  8  bit  transparent  latch,  74LS373  (U83)  and  a  Delay 
line  circuit  shared  with  Dynamic  RAM  timing  circuit  consisting 
Ot  a  74LS74  (U98),  74LS32  (U96),  74LS04  (U95),  74LS00 
(U92),  74LS02  (U69),  and  Delay  Line  (U94)  During  a  CPU 
Read  Access  to  the  Video  RAM.  the  address  is  decoded  by  the 
GA  4  2  and  asserts  VIDEO"  low  This  is  inverted  by  U95  ( 1  6  of 
74LS04)  which  pulls  one  input  of  U92  (1  4  of  74LSO0)  and  in 
turn  asserts  VWAIT  *  low  to  the  CPU  RD  is  high  at  this  time  and 
is  latched  into  U98  (1  2  of  74LS74)  on  the  rising  edge  of 
XADR7*.  inverse  of  CRTCLK 


When  RD  is  latched  by  U98  the  Q  output  goes  low  releasing 
WAIT*  from  the  CPU  The  same  signal  also  is  sent  to  the  Delay 
Line  (U94)  through  U1 1 7  (1  4  ol  74F08)  The  Delay  line  delays 
the  falling  edge  240  ns  for  VLATCH*  which  latches  the  read 
data  from  the  video  RAM  at  U83  The  data  is  latched  so  the 
CRTC  can  refresh  the  next  address  location  and  prevent  any 
hashing  MRD'  decoded  by  U106  and  a  memory  read  is  ORed 
with  VIDEO*  which  enables  the  data  from  U83 10  the  data  bus 
The  CPU  then  reads  the  data  and  completes  the  cycle  A  CPU 
write  is  slightly  more  complex  in  operation  As  in  the  RD  cycle, 
VIDEO*  is  asserted  low  which  asserts  VWAIT*  low  to  ihe  CPU 
WR  is  high  at  this  time  which  is  NANDed  with  VIDEO  and 
synced  with  CRTCLK  to  create  VRAMDIS  that  disables  the 
video  RAM  output  On  the  rising  edge  of  XADR7*.  WR  is 
latched  into  U98  ( 1  2  of  74LS74)  which  releases  VWAIT*  and 
starts  cycle  through  the  Delay  Line  After  30ns  DLYVWR*  (De- 
layed video  write)  is  asserted  low  which  also  asserts  VBUFEN* 
(Video  Buffer  Enable)  low  VBUFEN*  enabled  data  from  the 
Data  bus  to  the  video  RAM  Approximately  120ns  later 
DLYVWR*  is  negated  high  which  writes  the  data  to  the  video 
RAM  and  negates  VBUFEN*  turning  off  buffer  The  CPU  then 
completes  WR  cycle  to  the  video  RAM  Refer  to  Video  RAM 
CPU  Access  Timing  Figure  5-12  for  timing  of  above  RD  or  WR 
cycles 

During  screen  refresh,  CRTCLK  is  high  allowing  the  CRTC 
to  address  Video  RAM  The  data  out  of  the  video  RAM  is 
latched  by  LOAD*  into  Gate  Array  4  3  (U102)  INVERSE* 
determines  if  character  should  be  alpha-numeric  only  (IN- 
VERSE* high)  or  unchanged  (INVERSE*  low)  A9  is  de- 
coded with  ENALTSET  (Enable  Alternate  Set)  and  7,  which 
controls  the  alternate  set  in  the  character  generator  ROM 
See  ENALTSET  Control  Table  below 


ENALTSET 

Q7 

Q6 

A9 

0 

0 

0 

0 

0 

1 
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0 
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1 
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RA0-RA3,  row  addresses  from  the  CRTC  are  usea  to  control 
which  scan  line  is  being  displayed  The  Model  4P  has  a  4-bit  full 
adder  74LS283  (U101)  to  modify  the  Row  address  During  a 
character  display  DLYGRAPHIC"  is  high  which  applies  a  high  to 
all  4  bits  to  be  added  to  row  address  This  will  result  in  subtract 
mg  one  from  Row  address  count  and  allow  all  characters  to  be 
displayed  one  scan  line  lower  The  purpose  is  so  inverse  char- 
acters will  appear  within  the  inverse  block  When  a  graphic 
block  is  displayed  DLYGRAPHIC*  is  low  which  causes  the  row 
address  to  be  unmodified  Moving  jumper  from  E14-E15  to 
E15-E16  will  disable  this  circuit 

DLYCHAR"  and  DLYGRAPHICS  are  inverse  signals  and  control 
which  data  is  to  be  loaded  into  the  internal  shift  register  of  U1 02 
When  DLYCHAR"  is  low  and  DLYGRAPHIC  is  high,  the  Char- 
acter Generator  ROM  (U103)  is  enabled  to  output  data  When 
DLYCHAR*  is  high  and  DLYGRAPHIC*  is  low  the  graphics  char- 
acters are  internally  buffered  to  the  shift  register  The  data  is 
loaded  into  the  internal  shift  register  on  the  rising  edge  of 
SHIFT"  when  LOADS*  is  low  Serial  video  data  is  output 
U102  19  The  video  information  is  inverted  by  U1 42  and  F83,  is 
filtered  by  R14  (47  ohm  resistor),  and  C227  (100  pf  Cap)  and 
output  to  video  monitor  VSYNC  and  HSYNC  are  buffered  by  (1 ' 
2  of  74LS86)  U1 43  and  are  also  output  to  video  monitor  Refer 
to  Video  Circuit  Timing  Figure  4-12  and  Inverse  Video  Tim- 
ing Figure  4-13  for  timing  relationships  of  Video  Circuit 

4.2.9  Keyboard 

The  keyboard  interface  of  the  Model  4P  consists  of  open  col- 
lector drivers  which  drive  an  8  by  8  key  matrix  keyboard  and  an 
inverting  buffer  which  buffers  the  key  or  keys  pressed  on  the 
data  bus  The  open  collector  drivers  (U57  and  U77  (7416)  are 
driven  by  address  lines  A0-A7  which  drive  the  column  lines  of 
the  keyboard  matrix  The  ROW  lines  of  the  keyboard  are  pulled 
up  by  a  1  5  kohm  resistor  pack  RP2  The  ROW  lines  are  buff- 
ered and  inverted  onto  the  data  bus  by  U78  (74LS240)  which  is 
enabled  when  KEYBD*  is  a  logic  low  KEYBD*  is  a  memory 
mapped  decode  of  addresses  3800-3BFF  in  Model  lit  Mode 
and  F400-F7FF  in  Model  4/4P  mode  Refer  to  the  Memory  Map 
under  Address  Decode  for  more  information  During  real  time 
operation,  the  CPU  will  scan  the  keyboard  periodically  to  check 
if  any  keys  are  pressed  If  no  key  is  pressed,  the  resistor  pack 
RP2  keeps  the  inputs  of  U78  at  a  logic  high  U78  inverts  the 
data  to  a  logic  low  and  buffers  it  to  the  data  bus  which  is  read 
by  the  CPU  I*  a  key  is  pressed  when  the  CPU  scans  the  correct 
column  line,  the  key  pressed  will  pull  the  corresponding  row  to 
a  logic  low  U78  inverts  the  signal  to  a  logic  high  which  is  read 
by  the  CPU 


4.2.10  Reaf  Time  Clock 

The  Real  Time  Clock  circuit  in  the  Model  4P  provides  a  30  Hz 
(in  the  2  MHz  CPU  mode)  or  60  Hz  (in  the  4  MHz  CPU  mode) 
interrupt  to  the  CPU  By  counting  the  number  of  interrupts  that 
have  occurred  the  CPU  can  keep  track  of  the  time  The  60  Hz 
vertical  sync  signal  (VSYNC)  from  the  video  circuitry  is  used  for 
the  Real  Time  Clock  s  reference  In  the  2  MHz  mode,  FAST  is 
a  logic  low  which  sets  the  Preset  input  pin  4  of  U23  (74LS74) 
to  a  logic  high  This  allows  the  60  Hz  (VSYNC)  to  be  divided  by 
2  to  30  Hz  The  output  of  1/2  of  U23  is  ORed  with  the  original 
60  Hz  and  then  clocks  another  74LS74  (1  2  of  U23)  If  the  real 
time  clock  is  enabled  (ENRTC  at  a  logic  high),  the  interrupt  is 
latched  and  pulls  the  INT*  line  low  to  the  CPU  When  the  CPU 
recognizes  the  interrupt,  the  pulse  is  counted  and  the  latch  re- 
set by  pulling  RTCIN*  low  In  the  4  MHz  mode,  FAST  is  a  logic 
high  which  keeps  the  first  half  of  U23  in  a  preset  state  (the  Q* 
output  at  a  logic  low)  The  60  Hz  is  used  to  clock  the  interrupts 

NOTE:  If  interrupts  are  disabled,  the  accuracy  of  the  real 
time  clock  will  suffer 

4.2.1 1  Line  Printer  Port 

The  Line  Printer  Port  Interface  consists  of  a  pulse  generator,  an 
eight-bit  latch,  and  a  status  line  buffer  The  status  of  the  line 
printer  is  read  by  the  CPU  by  enabling  buffer  U3  (74LS244) 
This  buffer  is  enabled  by  LPRD"  which  is  a  memory  map  and 
port  map  decode  In  Model  III  mode,  only  the  status  can  be  read 
from  memory  location  37E8  or  37E9  The  status  can  be  read  in 
all  modes  by  an  input  from  ports  F8-FB  For  a  listing  of  the  bit 
status,  refer  to  Port  Map  section 

After  the  printer  driver  software  determines  that  the  printer  is 
ready  for  printing  (by  reading  the  correct  status)  the  characters 
to  be  printed  are  output  to  Port  F8-FB  U2,  a  74LS374  eight-bit 
latch,  latches  the  character  byte  and  outputs  to  the  line  printer 
One-half  of  U1  (74LS123),  a  one-shot,  is  then  triggered  which 
generates  an  appropriate  strobe  signal  to  the  printer  which  sig- 
nifies a  valid  character  is  ready  The  output  of  the  one-shot  is 
buffered  by  1  /6th  of  the  U51  (74LS04)  to  prevent  noise  from  the 
printer  cable  from  false-triggering  the  one-shot 
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4.2.12  Graphics  Port 


Addresses 


The  Graphics  Port  (J7)  on  the  Model  4P  is  provided  to  attach 
the  optional  Graphics  Board  The  port  provides  D0-D7  (Data 
Lines)  A0-A3  (Address  Lines)  IN-  GEN'  and  RESET*  for  the 
necessary  interlace  signals  for  the  Graphics  Board  GEN'  is 
generated  by  negative  ORing  Port  selects  GSELO*  (8C-8FH) 
and  GSELI*  (80-83H)  together  by  (1  4  of  74LS08)  U4  The  re 
suiting  signal  is  negative  ANDed  with  IORO*  by  (1  4  of  74S32) 
U24  Seven  timing  signals  are  provided  to  allow  synchroniza- 
tion of  Mam  Logic  Board  Video  and  Graphics  Board  Video 
These  timing  signals  are  VSYNC,  HSYNC,  DISPEN,  DCLK, 
H,  I,  and  J  Three  control  signals  from  the  Graphics  Board 
are  used  to  sync  to  CPU  access  and  select  different  video 
modes  WAIT*  controls  the  CPU  access  by  causing  the  CPU 
to  WAIT  till  video  is  in  retrace  area  before  allowing  any 
writes  or  reads  to  Graphics  Board  RAM  ENGRAF  is  as- 
serted when  Graphics  video  is  displayed  ENGRAF  also  dis- 
ables inverse  video  mode  on  Main  Logic  Board  Video 
CL166*  (Clear  74L166)  is  used  to  enable  or  disable  mixing 
of  Main  Logic  Board  Video  and  Graphics  Board  Video  If 
CL166*  is  negated  high,  then  mixing  is  allowed  in  all  four 
video  modes  80  x  24,  40  x  24,  64  x  16,  and  32  x  16  If 
CL166*  is  asserted  low,  this  will  clear  the  video  shift  register 
U63,  which  allows  no  video  from  the  Main  Logic  Board  In 
this  slate  8064*  is  automatically  asserted  low  to  put  screen 
in  80  x  24  video  mode  Refer  to  Figure  4-1 5  Graphic  Board 
Video  Timing  for  liming  relationships  Refer  to  the  Model  4/ 
4P  Graphics  Board  Service  information  for  service  or  techni- 
cal information  on  the  Graphics  Board 

4.2.13  Sound 

The  sound  circuit  in  the  Model  4P  is  compatible  with  the  Sound 
Board  which  was  optional  in  the  Model  4  Sound  is  generated 
by  alternately  setting  and  clearing  data  bit  DO  during  an  OUT  to 
port  90H  The  state  of  DO  is  latched  by  U1 29  (1  2  of  a  74LS74) 
and  the  output  is  amplified  by  Q2  which  drives  a  81 1  speaker 
The  speed  of  the  software  loop  determines  the  frequency  and 
thus,  the  pitch  of  the  resulting  tone  Since  the  Model  4P  does 
not  have  a  cassette  circuit,  some  existing  software  that  used 
the  cassette  output  for  sound  would  have  been  lost  The  Model 
4P  routes  the  cassette  latch  to  the  sound  board  through  U1 09 
When  the  CASSMOTORON  signal  is  a  logic  low  the  cassette 
motor  is  off,  then  the  cassette  output  is  sent  to  the  sound  circuit 

4.2.14  I/O  Bus  Port 

The  Model  4P  Bus  is  designed  to  allow  easy  and  convenient  in 
terfacing  of  I  O  devices  to  the  Model  4P  The  I  O  Bus  supports 
all  the  signals  necessary  to  implement  a  device  compatible  with 
the  Z80s  I  O  structure 


A0  to  A7  allow  selection  of  up  to  256*  input  and  256  output 
devices  if  external  I  O  is  enabled 

'Ports  80H  to  0FFH  are  reserved  for  System  use 

Data 

DB0  to  DB7  allow  transfer  of  8-bit  data  onto  the  processor 
data  bus  is  external  TO  is  enabled 

Control  Lines 

1  M1"  —  Z80A  signal  specifying  an  M1  or  Operation  Code 
Fetch  Cycle  or  with  IOREQ"  it  specifies  an  Inlerrupt 
acknowledge 

2  IN'  —  Z80A  signal  specifying  than  an  input  is  in  progress 
Logic  AND  of  IOREQ*  and  WR* 

3  OUT"  —  Z80A  signal  specifying  that  an  output  is  in  prog- 
ress Logic  AND  of  IOREQ*  and  WR* 

4  IOREQ*  —  Z80A  signal  specifying  that  an  input  or  output 
is  in  progress  or  with  M1*  it  specifies  an  interrupt 
acknowledge 

5  RESET*  —  system  reset  signal 

6  IOBUSINT"  —  input  to  the  CPU  signaling  an  interrupt  from 
an  I  O  Bus  device  if  I  O  Bus  interrupts  are  enabled 

7  IOBU  SWA  IT*  —  input  to  the  C  PU  wait  line  allowing  I  O  Bus 
device  to  force  wait  states  on  the  Z80  if  external  I  O  is 
enabled 

8  EXTIOSEL"  —  input  to  I  O  Bus  Port  circuit  which  switches 
the  I  O  Bus  data  bus  transceiver  and  allows  and  INPUT  in- 
struction to  read  I  O  Bus  data 

The  address  line  data  line  and  all  control  lines  except  RESET" 
are  enabled  only  when  the  ENEXIO  bit  in  port  EC  is  set  to  one 

To  enable  I  O  interrupts  the  ENIOBUSINT  bit  in  the  PORT  E0 
(output  port)  must  be  a  one  However  even  if  it  is  disabled  from 
generating  interrupts  the  status  of  the  IOBUSINT*  line  can  still 
read  on  the  appropriate  bit  of  CPU  IOPORT  EO  (input  port) 

See  Model  4P  Port  Bit  assignments  for  port  OFF  0EC  andOEO 
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The  Model  4P  CPU  board  is  fully  prelected  from  foreign  I  O  de- 
vices in  thai  all  the  I  O  Bus  signals  are  buffered  and  can  be  dis- 
abled under  software  control  To  attach  and  use  and  I  O  device 
on  the  I  O  Bus  certain  requirements  (both  hardware  and  soft- 
ware) must  be  met 

For  input  port  device  use,  you  must  enable  external  I/O  de- 
vices by  writing  to  port  OECH  with  bit  4  on  in  the  user  soft- 
ware This  will  enable  the  data  bus  address  lines  and  control 
signals  to  the  I/O  Bus  edge  connector  When  the  input  de- 
vice is  selected,  the  hardware  should  acknowledge  by  as- 
serting EXTIOSEL*  low  This  swilches  the  data  bus 
transceiver  and  allows  the  CPU  to  read  the  contents  ol  the  1/ 
O  Bus  data  lines  See  Figure  4-16  lor  the  timing  EXTIO- 
SEL* can  be  generated  by  NANDmg  IN  and  the  I/O  port 
address 

Output  port  device  use  is  the  same  as  the  input  port  device  in 
use,  in  that  the  external  I  O  devices  must  be  enabled  by  writing 
to  port  OECH  with  bit  4  on  in  the  user  software  —  in  the  same 
lashion 

For  either  input  or  output  devices,  the  IOBUSWAIT*  control  line 
can  be  used  in  the  normal  way  for  synchronizing  slow  devices 
to  the  CPU  Note  that  since  dynamic  memories  are  used  in  the 
Model  4P,  the  wait  line  should  be  used  with  caution  Holding  the 
CPU  in  a  wait  state  lor  2  msec  or  more  may  cause  loss  of  mem- 
ory contents  since  refresh  is  inhibited  during  this  time  It  is  rec- 
ommended that  the  IOBUSWAIT"  line  be  held  active  no  more 
than  500  (Jisec  with  a  25%  duty  cycle 

The  Model  4P  will  support  Z80  Mode  1  interrupts  A  RAM  jump 
table  is  supported  by  the  LEVEL  II  BASIC  ROMs  image  and  the 
user  must  supply  the  address  of  his  interrupt  service  routine  by 
writing  this  address  to  locations  403E  and  403F  When  an  in- 
terrupt occurs,  the  program  will  be  vectored  to  the  user-sup- 
plied address  if  I/O  Bus  interrupts  have  been  enabled  To 
enable  I/O  Bus  interrupts,  the  user  must  set  bit  3  of  Port  0EOH 

4.2.15  FDC  Circuit 

The  TRS-80  Model  4P  Floppy  Disk  Interface  pro  vices  a  stan- 
dard 5-1  4  floppy  disk  controller  The  Floppy  Disk  Interface 
supports  both  single  and  double  density  encoding  schemes 
Write  precompensation  can  be  software  enabled  or  disabled 
beginning  at  any  track,  although  the  system  software  enables 
write  precompensation  for  all  tracks  greater  than  iwenty-one 
The  amount  of  write  precompensation  is  1 25  nsec  and  is  not 
adjustable  One  or  two  drives  may  be  controlled  by  the  inter- 
face All  data  transfers  are  accomplished  by  CPU  data  re- 
quests In  double  density  operation,  data  transfers  are 
synchronized  to  the  CPU  by  forcing  a  wait  to  the  CPU  and  clear- 
ing the  wait  by  a  data  request  from  the  FDC  chip  The  end  of  the 
data  transfer  is  indicated  by  generation  of  a  non-maskable  in- 
terrupt from  the  interrupt  request  output  of  the  FDC  chip  A 
hardware  watchdog  timer  insures  that  any  error  condition  will 
not  hang  the  wait  line  to  the  CPU  lor  a  period  long  enough  to 
destroy  RAM  contents 
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Control  and  Data  Buffering 


"Only  one  of  these  bits  should  be  set  per  output 


The  Floppy  Disk  Controller  Board  ts  an  I  O  port  mapped  device 
which  utilizes  ports  E4H  FOH  F1H  F2H  F3H  and  F4H  The 
decoding  logic  is  implemented  on  the  CPU  board  (Refer  to  Par- 
agraph 5  1  5  Address  Decoding  lor  more  information  on  Port 
Map)  U70  is  a  bi-d'rectional  8-bit  transceiver  used  to  buffer 
data  to  and  from  the  FDC  and  RS-232  circuits  The  direction  of 
data  transfer  is  controlled  by  the  combination  of  control  signals 
DISKIN"  RS232IN"  RDINT'  and  RDNMI"  If  any  of  these  sig- 
nals is  active  (logic  low)  U70  is  enabled  lo  drive  data  onto  the 
CPU  data  bus  If  both  signals  are  inactive  (logic  high)  U70  is" 
enabled  lo  receive  data  from  the  CPU  board  data  bus  A  sec- 
ond buffer  (U36)  is  used  to  butter  the  FDC  chip  data  to  the  FDC 
RS232  Data  Bus  (BD0-BD7)  U36  is  enabled  all  the  time  and 
its  direction  controlled  by  DISKIN"  Again  if  DISKIN"  is  active 
(logic  low),  data  is  enabled  to  drive  from  the  FDC  chip  to  the 
Main  Data  Busses  If  DISKIN"  is  inactive  (logic  high)  data  is  en- 
abled lo  be  transferred  to  the  FDC  chip 

Nonmaskable  Interrupt  Logic 

Gate  Array  4  4  (U1 8)  is  used  to  latch  data  bits  D6  and  D7onthe 
rising  edge  of  the  control  signal  WRNMI*  This  enables  the  con- 
ditions which  will  generate  a  non-maskable  interrupt  to  the 
CPU  The  NM!  interrupt  conditions  which  are  programmed  by 
doing  an  OUT  instruction  to  port  E4H  with  the  appropriate  bits 
set  If  data  bit  7  is  set  an  FDC  interrupt  is  enabled  to  generate 
an  NMI  interrupt  If  data  bit  7  is  resel  interrupt  requests  request 
from  the  FDC  are  disabled  If  data  bit  6  is  set  a  Motor  Time  Out 
is  enabled  to  generate  an  NMI  interrupt  If  data  bit  6  is  reset,  in- 
terrupts on  Motor  Time  Out  are  disabled  An  IN  instruction  from 
port  E4H  enables  the  CPU  to  determine  the  source  of  the  non- 
maskable interrupt  Data  bit  7  indicates  the  status  of  FDC  in- 
terrupt request  (1NTRQ)  (0  =  true,  1  =  false)  Data  bit  6  indicates 
the  status  of  Motor  Time  Out  (0  =  true,  1  =  false)  Data  bit  5  in- 
dicates the  status  of  the  Resel  signal  (0  =  true  1  =  false)  The 
control  signal  RDNMI*  gates  this  status  onto  the  CPU  data  bus 
when  active  (logic  low) 

Drive  Select  Latch  and  Motor  ON  Logic 

Selecting  a  drive  prior  lo  disk  I  O  operation  is  accomplished  by 
doing  an  OUT  instruction  to  port  F4H  with  the  proper  bit  set  The 
following  table  describes  the  bit  allocation  of  the  Drive  Select 
Latch 


Hex  D  flip-flop  U54  (74L174)  latches  the  drive  select  bits  side 
select  and  FM"  MFM  bits  on  the  rising  edge  of  the  control  signal 
DRVSEL*  Gate  Array  4  4  (U18)  is  used  to  latch  the  Wait  Ena- 
ble and  Write  precompensation  enable  bits  on  the  rising  edge 
of  DRVSEL*  The  rising  edge  of  DRVSEL*  also  triggers  a  one- 
shot  (1  2  of  U54  74LS123)  which  produces  a  Motor  On  to  the 
disk  drives  The  duration  of  the  Motor  On  signal  is  approxi- 
mately three  seconds  The  spindle  motors  are  not  designed  for 
continuous  operation  Therefore  the  inactive  state  ol  the  Motor 
On  signal  is  used  to  clear  the  Drive  Select  Latch  which  de-se- 
lects any  drives  which  were  previously  selected  The  Motor  On 
one-shot  is  retnggerable  by  simply  executing  another  OUT  in- 
struction to  the  Drive  Select  Latch 

Wait  State  Generation  and  WAITIMOUT  Logic 

As  previously  mentioned,  a  wait  state  to  the  CPU  can  be  initi- 
aled by  an  OUT  to  the  Drive  Select  Latch  with  D6  set  Pin  18  of 
U18  will  go  high  alter  this  operation  This  signal  is  inverted  by 
1'4th  of  U1 5  and  is  routed  to  the  CPU  where  it  forces  the  Z80A 
into  a  wait  stale  The  Z80A  will  remain  in  the  wait  state  as  long 
as  WAIT*  is  low  Once  initiated,  the  WAIT"  will  remain  low  until 
one  ol  live  conditions  is  satisfied  If  INTRO,  DRQ  and  RESET, 
inputs  become  active  (logic  high)  it  causes  WAIT*  to  go  high 
which  allows  the  Z80  lo  exit  the  wait  state  An  internal  timer  in 
U1 8  serves  as  a  watchdog  timer  lo  insure  that  a  wait  condition 
will  not  persist  long  enough  lo  destroy  dynamic  RAM  contents 
This  internal  watchdog  timer  logic  will  limit  the  duration  of  a  wait 
to  1024p,sec,  even  if  the  FDC  chip  should  fail  to  generate  a 
DRO  or  an  INTRQ 

If  an  OUT  to  Drive  Select  Latch  is  initiated  with  D6  reset  (logic 
low),  a  WAIT  is  still  generated  The  internal  timer  in  U18  will 
count  lo  2  which  will  clear  the  WAIT  state  This  allows  the  WAIT 
to  occur  only  during  the  OUT  instruction  to  prevent  violating  any 
Dynamic  RAM  parameters 

NOTE:    This  automatic  WAIT  will  cause  a  5-1  usee  wait  each 
time  an  out  lo  Drive  Select  Latch  is  performed 


O 


Data  Bit 
DO 
D1 
02 
D3 
D4 

DS 

D6 
D7 


Function 

Selects  Drive  0  when  set" 

Selects  Drive  1  when  set* 

Selects  Drive  2  when  set* 

Selects  Drive  3  when  set* 

Selects  Side  0  when  reset 

Selects  Side  1  when  set 

Write  precompensation  enabled  when   set, 

disabled  when  resel 

Generates  WAIT  if  set 

Selects  MFM  mode  if  set 

Selects  FM  mode  if  resel 
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Clock  Generation  Logic 

A 16  MHz  crystal  oscillator  and  a  Gate  Array  4.4  (U18)  are  used 
to  generate  the  clock  signals  required  by  the  FDC  board.  The  6 
MHz  oscillator  is  implemented  internal  to  U18  and  a  quartz 
crystal  (Y2).  The  output  of  the  oscillator  is  divided  by  2  to  gen- 
erate an  8  MHz  clock.  This  is  used  by  the  FDC  1773  tor  all  in- 
ternal timing  and  data  separation.  U18  further  divides  the  16 
MHz  clock  to  drive  the  watchdog  timer  circuit. 

Disk  Bus  Output  Drivers 

High  current  open  collector  drivers  U15  and  U34  are  used  to 
buffer  the  output  signals  from  the  FDC  circuit  to  the  disk  drives. 

Write  Precompensation  and  Write  Data  Pulse  Shap- 
ing Logic 

All  Write  Precompensation  is  generated  internal  to  the  FDC 
chip  1773  (U17).  Write  Precompensation  is  enabled  when 
W6  goes  high  and  Write  Precompensation  is  enabled  from 
software.  This  signal  is  multiplexed  with  RDY  by  W6  is  fed 
into  pin  20  of  U17.  Write  Data  is  output  pin  22  of  U17  and  is 
shaped  by  a  one-shot  (1/2  of  U56)  which  stretches  the  data 
pulses  to  approximately  500  nsec. 
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Floppy  Disk  Controller  Chip 


BRG  Programming  Table 


The  1773  is  an  MOS  LSI  device  which  performs  the  functions 
of  a  floppy  disk  formatter  controller  in  a  single  chip  implemen- 
tation The  following  port  addresses  are  assigned  to  the  internal 
registers  ol  the  1773  FDC  chip 


Port  No. 

Function 

FOH 

Command  Status  Register 

F1H 

Track  Register 

F2H 

Sector  Register 

F3H 

Data  Register 

4.2.16  RS-232-C  Circuit 

RS-232C  Technical  Description 

The  RS-232C  circuit  for  the  Model  4P  computer  supports 
asynchronous  serial  transmissions  and  conforms  to  the  EIA 
RS-232C  standards  at  the  input-output  interface  connector 
(J4)  The  heart  of  the  circuit  is  the  TR1865  Asynchronous 
Receiver/Transmitter  U33  It  performs  the  job  of  converting 
the  parallel  byte  data  from  the  CPU  to  a  serial  data  stream 
including  start,  stop,  and  panty  bits  For  a  more  detailed  de- 
scription of  how  this  LSI  circuit  performs  these  functions,  re- 
fer to  the  TR1865  data  sheets  and  application  notes  The 
transmit  and  receive  clock  rates  that  the  TR1865  needs  are 
supplied  by  the  Baud  Rate  Generator  U73  (BR1943)  This 
circuit  takes  the  5  0688  MHz  supplied  by  the  system  timing 
circuit  and  the  programmed  information  received  from  the 
CPU  over  the  data  bus  and  divides  the  basic  clock  rate  to 
provide  two  clocks  The  rates  available  from  the  BRG  go 
from  50  Baud  to  19200  Baud  See  the  BRG  table  for  the 
complete  list 


Transmit' 

Receive 

Supported 

Nibble 

Baud 

16X 

by 

Loaded 

Rate 

Clock 

SETCOM 

OH 

50 

0  8  kHz 

Yes 

1H 

75 

1  2  kHz 

Yes 

2H 

110 

1  76  kHz 

Yes 

3H 

134  5 

2  1523  kHz 

Yes 

4H 

150 

2  4  kHz 

Yes 

5H 

300 

4  8  kHz 

Yes 

BH 

600 

9  6  kHz 

Yes 

7H 

1200 

19  2  kHz 

Yes 

8H 

1800 

28  8  kHz 

Vet 

9H 

2000 

32  081  kHz 

Yes 

AH 

2400 

38  4  kHz 

Ves 

BH 

3600 

57  6  kHz 

Yes 

CH 

4800 

76  8  kHz 

Yes 

DH 

7200 

115  2  kHz 

Yes 

EH 

9600 

153  6  kHz 

Yes 

FH 

19200 

307  2  kHz 

Yes 

The  RS-232C  circuit  is  port  mapped  and  the  ports  used  are  E8 
to  EB  Following  is  a  description  of  each  port  on  both  input  and 
output 


Port 

Input 

Output 

E8 

Modem  status 

Master  Reset,  enables  UART 
control  register  load 

EA 

UART  status 

UART  control  register  load  and 
modem  control 

E9 

Not  Used 

Baud  rate  register  load  enable 

bit 

Transmitter  Holding 

EB 

Receiver  Holding 

register 

register 

G 


Interrupts  are  supported  in  the  RS-232C  circuit  by  the  Interrupt 
mask  register  and  the  Status  register  internal  to  GA  4  5  (U31) 
which  allow  the  CPU  to  see  which  kind  of  interrupt  has  oc- 
curred Interrupts  can  be  generated  on  receiver  data  register 
full ,  transmitter  register  empty,  and  any  one  of  the  errors  —  par- 
ity, framing,  or  data  overrun  This  allows  a  minimum  of  CPU 
overhead  in  transferring  data  to  or  from  the  UART  The  interrupt 
mask  register  is  port  E0  (write)  and  the  interrupt  status  register 
is  port  E0  (read)  Refer  to  the  IO  Port  description  for  a  full  break- 
down of  all  interrupts  and  their  bit  positions 
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All  Model  I.  Ill,  and  4  software  written  lor  the  RS-232-C  interface 
is  compatible  with  (he  Model  4P  RS-232-C  circuit,  provided  the 
software  does  not  use  the  sense  switches  to  configure  the  in- 
terface. The  programmer  can  gel  around  this  problem  by  di- 
rectly programming  the  BRG  and  UART  for  the  desired 
configuration  or  by  using  the  SETCOM  command  of  the  disk 
operating  system  to  configure  the  interface.  The  TRS-80  RS- 
232C  Interface  hardware  manual  has  a  good  discussion  of  the 
RS-232C  standard  and  specific  programming  examples  (Cat- 
alog Number  26-1 145). 

Pinout  Listing 

The  following  list  is  a  pinout  description  of  the  DB-25  connector 
(PI)- 

Pin  No.  Signal 

1  PGND  (Protective  Ground) 

2  TD  (Transmit  Data) 

3  RD  (Receive  Data) 

4  RTS  (Request  to  Send) 

5  CTS  (Clear  To  Send) 

6  DSR  (Data  Set  Ready) 

7  SGND  (Signal  Ground) 

8  CD  (Carrier  Detect) 

19  SRTS  (Spare  Request  to  Send) 

20  DTR  (Data  Terminal  Ready) 
22  Rl  (Ring  Indicate) 
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Model  4P  Gate  Array 

I/O  Pi 

n  Assignments 

J1 

J2 

J3 

Pin 

Signal 

Pin 

Signal 

Pin 

Signal 

No. 

No. 

No. 

1. 

DATA  STROBE 

1. 

XD0 

1. 

XD0 

2. 

GND 

2. 

GND 

2. 

GND 

3. 

PDO 

3. 

XD1 

3. 

XD1 

4. 

GND 

4. 

GND 

4. 

GND 

5. 

PD1 

5. 

XD2 

5. 

XD2 

6. 

GND 

6. 

GND 

6. 

GND 

7. 

PD2 

7. 

XD3 

7. 

XD3 

8. 

GND 

8. 

GND 

8. 

GND 

9. 

PD3 

9. 

XD4 

9. 

XD4 

10. 

GND 

10. 

GND 

10. 

GND 

11. 

PD4 

11. 

XD5 

11. 

XD5 

12. 

GND 

12. 

GND 

12. 

GND 

13. 

PD5 

13. 

XD6 

13. 

XD6 

14. 

GND 

14. 

GND 

14. 

GND 

15. 

PD6 

15. 

XD7 

15. 

XD7 

16. 

GND 

16. 

GND 

16. 

GND 

17. 

PD7 

17. 

XA0 

17. 

XAO 

18. 

GND 

18. 

GND 

18. 

GND 

19. 

N/A 

19. 

XA1 

19. 

XA1 

20. 

GND 

20. 

GND 

20. 

GND 

21. 

BUSY 

21. 

XA2 

21. 

XA2 

22. 

GND 

22. 

GND 

22. 

GND 

23. 

OUTPAPER 

23. 

XA3 

23. 

XA3 

24. 

GND 

24. 

GND 

24. 

GND 

25. 

UNIT  SELECT     - 

25. 

XA4 

25. 

XA4 

26. 

NC 

26. 

GND 

26. 

GND 

27. 

GND 

27. 

XA5 

27. 

XA5 

28. 

FAULT 

28. 

GND 

28. 

GND 

29. 

N/A 

29. 

XA6 

29. 

XA6 

30. 

N/A 

30. 

GND 

30. 

GND 

31. 

NC 

31. 

XA7 

31. 

XA7 

32. 

N/A 

32. 

GND 

32. 

GND 

33. 

NC 

33. 

XIN* 

33. 

XIN* 

34. 

GND 

34. 

GND 

34. 

GND 

35. 

35. 

XOUT* 

35. 

XOUT* 

36. 

36. 

GND 

36. 

GND 

37. 

37. 

XRESET* 

37. 

XRESET* 

36. 

38. 

GND 

38. 

GND 

38. 

39. 

IOBUSINT* 

39. 

IOBUSINT* 

40. 

40. 

GND 

40. 

GND 

41. 

41. 

IOBUSWAIT* 

41. 

IOBUSWAIT* 

42. 

42. 

GND 

42. 

GND 

43. 

43. 

EXTIOSEL" 

43. 

EXTIOSEL* 

44. 

44. 

GND 

44. 

GND 

45. 

45. 

NC 

45. 

NC 

46. 

46. 

GND 

46. 

GND 

47. 

47. 

XMI* 

47. 

XMI* 

46. 

48. 

GND 

48. 

GND 

49. 

49. 

XIOREQ* 

49. 

XIOREQ* 

50. 

50. 

GND 

50. 

GND 

o 
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J4 


J5 


J7 


J9 


Pin 

Signal 

No. 

1. 

PGND 

2. 

TD 

3. 

RD 

4. 

CTS 

5. 

DSR 

6. 

CD 

7. 

SGND 

8. 

CD 

9. 

10. 

11. 

12. 

13. 

14. 

15. 

16. 

17. 

18. 

19. 

SRTS 

20. 

DTR 

21. 

22. 

Rl 

23. 

24. 

25. 

26. 

27. 

28. 

29. 

30. 

31. 

32. 

33. 

34. 

Pin   Signal 

Pin 

Signal 

Pin 

Signal 

No. 

No. 

No. 

1.    GND 

1. 

DO 

1. 

GND 

2. 

2. 

D1 

2. 

VOUT 

3.    GND 

3. 

D2 

3. 

GND 

4. 

4. 

D3 

4. 

VERTSYNC* 

5.    GND 

5. 

D4 

5. 

GND 

6.                *     & 

6. 

D5 

6. 

HORZSYNC 

7.    GND 

7. 

D6 

7. 

8.    DIP" 

8. 

D7 

8. 

9.    GND 

9. 

GEN* 

9. 

10.    DSO* 

10. 

DCLK 

10. 

11.    GND 

11. 

A0 

11. 

12.    DS1* 

12. 

A1 

12. 

13.    GND 

13. 

A2 

13. 

14.           •  '      * 

14. 

J 

14. 

15.    GND 

15. 

GRAFVID 

1*. 

16.    MOTORON* 

16. 

ENGRAF 

16. 

17.    GND 

17. 

DISPEN 

17. 

18.    DIR* 

18. 

VSYNC 

18. 

19.    GND 

19. 

HSYNC 

19. 

20.    STEP* 

20. 

RESET* 

20. 

21.    GND 

21. 

WAIT* 

21. 

22.    WD* 

22. 

H 

22. 

23.    GND 

23. 

I 

23. 

24.    WG* 

24. 

IN* 

24. 

25.    GND 

25. 

GND 

25. 

26.    DTRK0* 

26. 

+  5V 

26. 

27.    GND 

27. 

27. 

28.    DWPRT* 

28. 

CL166* 

28. 

29.    GND 

29. 

GND 

29. 

30.    DRRD* 

30. 

+  5V 

30. 

31.    GND 

31. 

GND 

31. 

32.    SDSEL 

32. 

+  5V 

32. 

33.    GND 

33. 

GND 

33. 

34. 

34. 

+  5V 

J^. 

f ,'tre^o <^vU ^    o^-j    ^ItruvOv.     -i  ^ i  -  lj  -  >->*tCfH  C^r    J^^0/ 


/»a 


l'  Ol  t~l       f-  r^-V\  /  Ctw  S  u 


■^Al 


3? 


A 

/i 

/I 

2 

'r' 

3 

•** 

SI 

3    u/ovj 

7 

s 

2o 

A 

s\ 

Q/ 

'o 

* 

yi 

U/i0 

4 
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SECTION  V 


CHIP  SPECIFICATIONS 


J 
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CHIP  SPECIFICATIONS 


4P 


4  GATE  ARRAY 


4P GATE  ARRAY 


Motorola 

Motorola 

Motorola 

Motorola 

MC6835 

MC  6835 

MC  6835 

MC  6835 

Western  Digital 

Western  Digital 

Western  Digital 

BR  1943 

BR  1943 

BR  1943 

(BR  1941  L) 

FD  1793 

TR  1865 

TR  1865 

(WD  179X) 

FDC9216 

WD  1773 

WD  1773 

TR  1865 

WD  1943  00 

MATRA 

MATRA 

MMI 

MMI 

Timing  A.  (4.1.1) 

Timing  A.  (4.1  .1 ) 

PAL16RGA  (166) 

PAL16RGAS.T. 

Address  A.  (4.2.0) 

Address  A.  (4.2.0) 

PAL  10L8  (208) 

PAL10L8  V.T. 
PAL10L8C.T. 

Video  A.  (4.3.0) 

Video  A.  (4.3.0) 

PAL  16L8  (268) 

PAL16L8  MeMep 

VTI 

VTI 

PAL  16L8  (368) 

PAL  16L8  Page  Mep 

FDC  A.  (4.4.0) 

FDC  A.  (4.4.0) 

RS-232  A.  (4.5.0) 

RS-232  A.  (4.5.0) 

Zilog 

Zilog 

Zilog 

Zilog 

280  A 

280  A 

280  A 

280  A 
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ARRAY*:      4.1.1 

CIRCUIT  NAME:      System  Timing 

NO.  OF  PINS:      24 

MAX.  CLOCK  FREG.:      20.2752  MHz 

OPERTEMP.:      0°Cto70°C 

OPERATING  VOLTAGE  &  RANGE:      5  V  ±  5% 
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20. 275- 
MHZ 

crysta: 

— 

OSC. 

2J_ 
r.T 

k 

1.2672MHZ 

16 

U— i 

PLL 

12.672ME 

Z 

► 

NE56  4 

4  ' 

10 

1 

1.2672MHZ 

FAST 

§#64* 

MODS EL 

MA# 

PCLK 
RS232CLK 


SHIFT* 

XADR7* 

CRTCLK 

LOADS* 

DDT* 

LOAD* 

DCLK 

H 

I 

J 


o 


24  PIN  CHIP 
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XTALJ^ 

© 

V 

XTAL1 

© 

1.2M16 

© 

12M 

© 

1.2MLBT 

© 

FAST 

© 

8J0T64* 

© 

4.1.1 

MODS EL 

© 

MPJtf 

© 

N.C. 

© 

J 

© 

GND 

@ 

(24)  VCC 

@>  PCLK 

@  RS232CLK 

(21)  SHIFT* 

@  XADR7* 

@  CRTCLK 

(fjj)  LOADS* 

(5/7)  DOT* 

@  LOAD* 

@  DCLK 

<8>  H 
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SYSTEM  TIMING  SPECS 


NUMBER       PARAMETER 


MIN. 


1 

20M  Cycle  Time 

2 

20M  Pulse  Width  (High) 

20 

3 

20M  Pulse  Width  (Low) 

20 

4 

10M  Cycle  Time 

5 

10M  Pulse  Width  (High) 

45  40 

6 

10 M  Pulse  Width  (Low) 

45  40 

7 

RS232CLK  Cycle  Time 

8 

FSS232CLK  Pulse  Width  (High) 

92 

g 

RS232CK  Pulse  Width  (Low) 

92 

10 

PCLK*  (Fast)  Cycle  Time 

n 

PCLK*  (Fast)  Pulse  Width  (High) 

110 

12 

PCLK*  (Fast)  Pulse  Width  (Low) 

110 

13 

PCLK*  (/Fast)  Cycle  Time 

14 

PCLK*  (/Fast)  Pulse  Width  (High) 

180 

15 

PCLK*  (/Fast)  Pulse  Width  (Low) 

180 

16 

PCLK*  Rise  Time 

17 

PCLK*  Fall  Time 

TYP. 

49.3 

98.6 
197.2 
246.6 
493.2 


MAX. 


13 
13 


UNITS 
ns 

CM 
III 

ns 
iw 
ns 
m 
m 
m 
in 
ns 
ns 
ns 
ns 
ns 
ns 
ns 


• 


Input  Voltage  Level  (High) 
Input  Voltage  Level  (Low) 
Output  Voltage  Level  (High) 
Output  Voltage  Level  (Low) 


DC  CHARACTERISTICS  (ALL  PINS) 
2.0 


23 


3.S 
36 


.6 


V 
V 
V 
V 


(ALL  PINS  EXCEPT  CRTCLK  OUTPUT) 


Input  Current  Level  (High) 
Input  Current  Level  (Low) 
Output  Current  Level  (High) 
Output  Current  Level  (Low) 


-160 
3.2 


40 

t* 

1.6 

ma 

l» 

ma 

o 


Output  Current  Level  (High) 
Output  Current  Level  (Low) 


(CRTCLK  OUTPUT) 

-400 
8 


V* 
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EH 

EH 

en 
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2 
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fe 
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m 

u: 

t< 

s 

CM 

J 

J 

o 

w 

u 

a 

.H 

od 

Cn 

Cn 
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VIDEO  TIMING  SPECS 


10.1376  MHz 

12.672  MHz 

NUMBER 

PARAMETER 

MIN. 

TYP. 

MAX. 

MIN. 

TYP.          MAX. 

UNI 

1 

VCLK  Cycle  Time 

98.6 

78.9 

n$ 

2 

VCLK  Pulse  Width  (High) 

40 

30 

ns 

3 

VCLK  Pulse  Width  (Low) 

40 

30 

ns 

4 

DCLK  Cycle  Time 

98.6 

78.9 

ns 

5 

DCLK  Pulse  Width  (High) 

40 

30 

n$ 

6 

DCLK  Pulse  Width  (Low) 

40 

30 

ns 

7 

DOT  Cycle  Time 

98.6 

78.9 

ns 

8 

DOT  Pulse  Width  (High) 

40 

30 

ns 

9 

DOT  Pulse  Width  (Low) 

40 

30 

ns 

10 

DCLK  ito  DOT  t 

S 

5 

ns 

11 

DCLK  ttoH,  I,  J  tl 

27 

27 

ns 

12 

H  Cycle  Time 

197.2 

157.8 

ns 

13 

H  Pulse  Width  (High) 

90 

70 

ns 

14 

H  Pulse  Width  (Low) 

90 

70 

ns 

15 

I  Cycle  Time 

394.4 

315.6 

ns 

16 

I  Pulse  Width  (High) 

190 

150 

ns 

17 

I  Pulse  Width  (Low) 

190 

150 

ns 

18 

J  Cycle  Time 

788.8 

631.2 

ns 

19 

J  Pulse  Width  (High) 

385 

305 

ns 

20 

J  Pulse  Width  (Low) 

385 

305 

ns 

21 

SHIFT  Cycle  Time 

(64x16  &  80x24  Mode) 

98.6 

78.9 

ns 

(32x16  &40x24  Mode) 

197.2 

157.8 

ns 

22 

SHIFT  Pulse  Width  (Low) 

30 

30 

ns 

23 

SHIFT  tto  LOADS  4- 

0 

27* 

0 

27* 

ns 

24 

LOADS  I  to  SHIFT  t 

50* 

50* 

ns 

25 

LOADS  Pulse  Width  (Low) 

70 

98.6 

70 

78.9 

ns 

26 

LOADS  tto  SHIFT  t 

50* 

50* 

ns 

27 

LOADS  Cycle  Time 

(64x16  &  80x24  Mode) 

788.8 

631.2 

ns 

(32x16  &  40x24  Mode) 

1577.6 

1262.4 

ns 

28 

SHIFT  Tto  LOAD  t 

5 

5 

ns 

29 

LOAD  Pulse  Width  (Low) 

40 

30 

ns 

30 

LOAD  Cycle  Time 

(64x16  &  80x24  Mode) 

788.8 

631.2 

ns 

(32x16  &  40x24  Mode) 

1577.6 

1262.4 

ns 

31 

LOAD  ttoCRTCLK  1 

0 

27 

0 

27 

ns 

32 

CRTCLK  Cycle  Time 

788.8 

631.2 

ns 

33 

CRTCLK  Pulse  Width  (High) 

385 

305 

ns 

34 

CRTCLK  Pulse  Width  (Low) 

385 

305 

ns 

35 

CRTCLK  HtoXADR7  It 

5 

5 

ns 

36 

XADR7  Cycle  Time 

788.8 

631.2 

ns 

37 

XADR7  Pulse  Width  (High) 

385 

305 

ns 

38 

XADR7  Pulse  Width  (Low) 

385 

305 

ns 

o 


• 
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4.1 

PIN  SIGNAL 

23  PCLK 

22  RS232CK 

21  SHIFT* 


* 


20  XADR7 

19  CRTCLK 

18  LOADS* 

17  DOT* 


16  LOAD 

15  DCLK 

14  H 

13  I 

11  J 


* 


MAX. 

CAPACITANCE 

35  pf 

105  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 
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ARRAY*:      4.2.1 

CIRCUIT  NAME:   Address  Decode 

NO.  OF  PINS:      40 

MAX.  CLOCK  FREQ.:      4  MHz 

OPER.  TEMP.:      0°Cto70°C 

OPERATING  VOLTAGE  &  RANGE:   5±  5% 


O 
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+  5V 


MI 
IOREQ 

RD 

WR 
MREQ 
RFSH 

DESPAGE  m 

EN PAGE  » 

SRC PAGE  * 

SEL1  m 

SEL#  » 

A15 
A14 
A13 
A12 
All 
Aljfr 
LP  ADD 

SIXTN 
MOD4P 


IN* 

OUT* 

^-  MRD* 

*-  MWR* 

RASENJ0<* 

RASEN1* 

MAPA15 

RAMBUSDIR 

RAMBUS EN* 

RAMRDEN/MCYCEN  ( RAMRDMCYC ) 

RAMWREN/ROMB* 

BUSDIR* 
BUSEN* 

VIDEO* 
KEYBD* 
^-     ROMCE*/ROMC* 

LPRQ* 

ROM* /ROMA* 
(I/O) 


4%   PINS  USED 
4&   PIN  CHIP 

A.2.& 
ADDRESS  DECODE 
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Ml 

© 

V 

IOREQ 

© 

RD 

© 

WR 

© 

MREQ 

© 

RFSH 

© 

A15 

© 

A14 

© 

A13 

© 

A12 

© 

4.2.1 

All 

© 

Altf 

© 

LP  ADD 

© 

LPRQ* 

© 

DESPAGE 

© 

EN PAGE 

© 

SRCPAGI 

;© 

SEL1 

@ 

SELJ0T 

© 

GND 

© 

(40)  VEC 
(39)  IN* 
(38)  OUT* 
(37)  MRD* 
(36)  MOD4P 
(35)  MWR* 
(34)  RASEN#* 
(g)  RASENI* 
(g)  MAPA15 
(3^)  RAMBUSDIR 

(g)  RAMBUSEN* 

(g)  RAMRDEN/MCYCEN 

(J§)  RAMWREN/ROMB* 

(g)  BUSDIR* 

@  BUSEN* 

@  SIXTN 

(24)  VIDEO* 

(23)  KEYBD* 

(2^>  ROMCE*/ROMC* 

(£l)  ROM*/ROMA* 


o 


• 
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SIGNAL  NAME 

MODEL  A  MODE 

MODEL  4  MODE 

MDD4P 

"|"  =  +SV 

"0"=  GND 

Ml 

Ml 

Ml 

I 

IOREQ 

IOREQ 

IOREQ 

1 

RD 

RD 

RD 

I 

WR 

WR 

WR 

I 

MREQ 

MREQ 

IOREQ 

I 

RFSH 

RFSH 

RFSH 

I 

DESPAGE 

DESPAGE 

DESPAGE 

I 

ENPAGE 

ENPAGE 

ENPAGE 

I 

SRCPAGE 

SRCPAGE 

SRCPAGE 

I 

SEL1 

SEL1 

SEL1 

I 

SEL0 

SEL0 

SEL0 

1 

A15 

A15 

A15 

I 

A14 

A14 

A14 

I 

A13 

A13 

A13 

I 

A12 

A12 

A12 

1 

A11 

Alt 

A11 

I 

A10 

Alt 

A10 

I 

LPADD 

LPADD 

LPADD 

I 

SIXTN 

SIXTN 

SIXTN 

1 

IN* 

IN* 

0 

IN* 

0 

OUT* 

OUT* 

0 

OUT* 

0 

MRD* 

MRD* 

0 

MRD* 

0 

MWR* 

MWR* 

0 

MWR* 

o 

RASEN0* 

RASEN0* 

0 

RASEN0* 

0 

RASEN1* 

RASEN1* 

0 

RASEN1* 

0 

MAPA15 

MAPA15 

0 

MAPA15 

o 

RAMBUSDIR 

RAMBUSDIR 

0 

RAMBUSDIR 

0 

RAMBUSEN* 

RAMBUSEN* 

0 

RAMBUSEN* 

o 

{RAMRDMCYC)  RAM  RDEN/MCYCEN 

RAMRDEN 

0 

MCYCEN 

0 

RAMWREN/ROMB* 

RAMWREN 

0 

ROMB* 

0 

BUSDIR* 

BUSDIR* 

0 

BUSDIR* 

0 

BUSEN* 

BUSEN4P* 

0 

DATACNT* 

o 

VIDEO* 

VIDE04P* 

0 

VIDE04* 

0 

KEYBD* 

KEYBD4P* 

0 

KEYBD4* 

0 

ROMCE*/ROMC* 

ROMCE* 

0 

ROMC* 

o 

LPRQ* 

LPRQ* 

0 

LPRQ* 

0 

ROM*/ROMA* 

ROM* 

I 

ROMA* 

o 

I    =  INPUT 

0  =  OUTPUT 
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1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 


PARAMETER 


IOREQ  U  *  RD  tlto  IN  It 

IOREQ  tl  *  WR  H  to  OUT  It 

RD  tlto  MRP  It 

WR  tltoMWR  It 

A15  tlto  RASEN0  tl 

A15  tlto  RASEN1  tl 

A15  tltoMAPA15  tl 

RD  It  to  RAMBUSPIR  It 

MREQ  tlto  RAMBUSEN  It 

A15-A10  tl  to  RAMRDMCYC  tl 

A15-A14  tlto  RAMWREN  tl 

MREQ  tlto  ROMB  It 

IOREQ  tlto  BUSDIR  It 

RD  tlto  BUSDIR  It 

MREQ  tlto  BUSEN  It 

MREQ  tlto  VIDEO  It 

MREQ  tlto  KEYBD  It 

MREQ  tlto  ROMCE  It 

MREQ  tlto  ROMC  It 

MREQ  tlto  LPRQ  It 

MREQ  tl  to  ROMA  It 

PCLK  tltoPCLKlt 

PCLK  Cycle  Time 

PCLK  ttoM1  t 

PCLK  I  to  MREQt 

A10-A15  tlto  MREQ  t 

PCLK  I  to  RD  t 

PCLK  tto  A10-A15  tl 

PCLK  tto  A10-A15  tl 

PCLK  ttoM1  I 

PCLK  tto  MREQ  I 

MREQ  I  to  MREQ  t 

PCLK  tto  RD  I 

PCLK  tto  RFSH  t 


RFSH  tl  to  RASEN  0  or  R  ASEN1  tl 

PCLK  I  to  MREQ  I 

MREQ  Pulse  Width  (High! 

PCLK  tto  RFSH  I 

A1-A9  tl  to  LPADD  tl 

PCLK  ItoWR  tl 

PCLK  I  to  RD  I 

Control  Lines  tl  to  Affected  Signals  tl 

A0-A15  tlto  IOREQ  t 

PCLK  tto  IOREQ  t 

PCLK  tto  RD  t 

PCLK  ttoWR  t 


SPECS 

MIN.             TYP. 

MAX. 

UNI! 

35 

ns 

35 

ns 

35 

ns 

35 

ns 

50 

ns 

50 

ns 

50 

ns 

35 

ns 

35 

ns 

50 

ns 

50 

ns 

35 

ns 

35 

ns 

35 

ns 

50 

ns 

35 

ns 

35 

ns 

35 

ns 

35 

ns 

35 

ns 

35 

ns 

110               123 

ns 

246 

ns 

106 

ns 

91 

ns 

50 

ns 

101 

ns 

128 

ns 

128 

ns 

136 

ns 

91 

ns 

110 

ns 

91 

ns 

136 

ns 

35 

ns 

91 

ns 

220 

126 

ns 

30 

ns 

86 

ns 

91 

ns 

200 

35 

ns 
ns 

81 

ns 

91 

ns 

71 

ns 

• 


o 
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CO 
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w  ci] 


Ht 


co 
u 
z 


o 

EC 
H 

z 

o 
u 


w 

z  w 

W  to 


• 


o 


■H    CO 

z  z> 

M  CO 
CO  S, 

<   < 

at  dc 


CO 


Ed  W  »     * 

U  O      o  in 

<  <         Z  .-i 

Cu  Cu  3JH  < 

CO  U  JcO  Cu 

ta  a:  w<  <: 

Q  <o  CO  OS  s 


u 

CJ 
Q 

as  - 
£  * 

<  CQ 
as  £ 

O 
*  cc 

z     - 

Ed  Z 
CO   Ltl 

3  as 
CQ  3 
2  S 

<  < 
OS  OS 


*  * 

o  w    * 

£tl  O  * 
Q   S  O 

HO* 

>  oc  a. 

j 

*  *     «. 
z  o  *   * 
Mmo< 
co  x  s  s: 

3   U  O  O 
CQ   :«   OS  OS 
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DC  CHARACTERISTICS  (ALL  PINS)  0°  -  70°  C 


PARAMETER 

MIN. 

TYP. 

Input  Voltage  Level  (High) 

2.0 

Input  Voltage  Level  (Low) 

Output  Voltage  Level  (High) 

2.7 

3.5 

Output  Voltage  Level  (Low) 

.35 

MAX.  UNITS 

V 

.8  V 

V 

.5  V 


(ALL  PINS  EXCEPT  OUT*,  RAMRDEN/MCYCEN) 

Input  Current  Level  (High)  20                                      Ma 

Input  Current  Level  (Low)  —.4                                  ma 

Output  Current  Level  (High)                        -200  ixn 

Output  Current  Level  (Low)                               4  ma 

(OUT*,  RAMRDEN/MCYCEN) 

Output  Current  Level  (High)                         -400  jua 

Output  Current  Level  (Low)                               8  ma 


O 
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ft 


^ 


PIN 

39 
38 
37 
35 
34 
33 
32 
31 
30 
29 
28 
27 
26 
24 
23 
22 
(OUTPUT)  21 
14 


SIGNAL 

IN* 

OUT* 

MRD* 

MWR* 

RASEN0* 

RASEN1* 

MAPA15 

RAMBUSDIR 

RAMBUSEN* 

RAMRDEN/MCYCEN 

RAMWREN/ROMB* 

BUSDIR* 

BUSEN* 

VIDEO* 

KEYBD* 

R0MCE7R0MC* 

ROMA* 

LPRQ* 


MAX. 

CAPACITANCE 

35  pf 

35  pf 

35  pf 

128  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 
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ARRAY  #:     4.3.0 

CIRCUIT  NAME:      Video  Support 

NO.  OF  PINS:     40 

MAX.  CLOCK  FREQ.:      12.672  MHz 

OPE R.  TEMP.:    0°Cto70°C 

OPERATING  VOLTAGE  &  RANGE:      5  ±  5% 


G 


9 
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+  5V 


SRD# 

SRD1 

SRD2 

SRD3 

SRD4 

SRD5 

SRD6 

SRD7 


DISPEN  *• 

RA2  m 

RA3  » 

DLYCHAR  - 

DLYCHAR*  - 

CGA3  - 

CGA4  -* 

CGA5  -* 

CGA6  -* 

CGA7  - 

CGA8  - 


CGA9  -*- 
CGAl#  -*- 


-  VOUT* 

m  INVERSE 

m  EN ALTS ET 

m  LOAD* 

m  LOADS* 

m  SHIFT* 

m  ENGRAF 

«•  GRAFVID 

4  CL166* 


CGDJ& 

CGD1 

CGD2 

CGD3 

CGD4 

CGD5 

CGD6 

CGD7 


39  PINS  USED 


40  PIN  CHIP 


4.3.Jef 


VIDEO  SUPPORT 
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CGA7 

1 

CGA8 

2 

CGA9 

3 

CGALtf" 

4 

SRD7 

5 

SRD6 

6 

SRD5 

7 

SRD4 

8 

SRD3 

9 

SRD2 

10 

SRDl 

11 

SRDO 

12 

DLYCHAR* 

13 

DLYCHAR 

14 

DISPEN 

15 

CL166* 

16 

ENGRAF 

17 

GRAFVID 

18 

VOUT  * 

19 

GND 

20 

40  +5V 

3  9  CGA6 

38  CGA5 

37  CGA4 

36  CGA3 

35  RA3 

34  RA2 

33  CGD7 

32  CGD6 

31  CGD5 

30  CGD4 

29  CGD3 

28  CGD2 

27  CGD1 

26  CGDO 

25  INVERSE 

2  4  EN ALTS ET 

23  LOAD* 

22  LOADS* 

21  SHIFT* 


O 
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PARAMETER  MIN.  TYP. 


1**  SRD0-SRD7  Hto  LOAD  t      61 

2*  Inputs  D0-D7  of  LS273  H  to  LOAD  t  20 

3  LOAD  t  to  CGA3-CGA10  H  0 

4  R  A2,  R  A3  H  to  Outputs  of  LS1 53  H  0 

5  Inputs  CGA3-CGA1 0 of  LS1 53  H  to  Outputs  H  0 

6  DLYGRAPHIC  4  to  Outputs  of  LS244  t4  0 

7  D  L  YG  R  APH IC  t  to  Outputs  of  LS244  Tristate  0 

8  ENALTSET  H  to  CGA9  t4  0 

9  INVERSE  t4  to  Inputs  D7  of  LS273  t4  0 

10  INVERSE  Hto  INVDISPEN,  CHAR  H  0 

11  INVERSE  Hto  Input  to  51  H  0 

12  SRD6  t4  to  CHAR  t4  0 

13  D1SPEN  Hto  Input  D0of  LS175  t4  0 

14  DISPEN  f  4  to  INVDISPEN  t4  0 

15  ENGRAF  Hto  INVDISPEN  t4  0 

16  ENGRAF  Hto  Inputs  of  51  H  0 

17  GRAFVID  Hto  Inputof  51  H  0 
20**  CGD0-CGD7  Hto  LOADS  4  &  SHIFT  t  100 

21  RA3  HtoDLYBLANKH                                      0  27 

22  LOAD  t  to  DLYBLANK  H                                     0  27 
23**  LOADS  4  to  SHI  FT  1  50 

24  *  SHFT/LD  4  to  SHIFT  t  30 

25  CL166  H  to  QH  H  0 
26*  LOAD  t  to  SHIFT  t           

271  LOAD  tto  VIDE02  H  =  SHIFT  t  to  VIDE01  H 

28  GRAFVID  H  to  VIDE02  H 0 

29  VIDE02  H  ,  VIDE01  Hto  VOUT  H  0 

30  ENGRAF  t4  to  VIDE02  H  0 

31  DLYCHAR*  t  to  CGD0-CGD7  Tristate 

32  CRTCLK  4  to  DISPEN 


SPECS 

MAX. 

UNI! 

ns 

ns 

60 

ns 

38 

ns 

30 

ns 

30 

ns 

30 

ns 

35 

ns 

35 

ns 

40 

ns 

20 

ns 

40 

ns 

20 

ns 

40 

ns 

40 

ns 

20 

ns 

5 

ns 

ns 

50 

ns 

50 

ns 

ns 

ns 

30 

ns 

±  5 

ns 

+  5 

ns 

15 

ns 

20 

ns 

15 

ns 

150 

ns 

300 

ns 

1  The  delay  from  LOAD  t  to  VIDE02  H  should  equal  the  delay  from  SHIFT  t  to  VIDE01  H. 

Specs  required  for  TLL  components— can  be  changed  to  meet  the  setup  &  hold  time  specs  of  array  logic. 
** Specs  provided  are  for  reference,  timing  is  from  external  logic. 
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DC  CHARACTERISTICS  (ALL  PINS)  0°  -  70°  C 

PARAMETER  MIN.                          TYP.                             MAX.                           UNITS 

Input  Voltage  Level  (High)  2.0                                                                                                      V 

Input  Voltage  Level  (Low)  ,8                                   V 

Output  Voltage  Level  (High)  2.7                            3.5                                                                      V 

Output  Voltage  Level  (Low)  .35                             .5                                  V 

Input  Current  Level  (High)  20                                       /la 

Input  Current  Level  (Low)  —.4                                    ma 

Output  Current  Level  (High)  -200                                                                                                                 fa 

Output  Current  Level  (Low)  4                                                                                                           ma 
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4.3 


PIN 

4 

3 

2 

1 
39 
38 
37 
36 
13 
14 
19 


SIGNAL 

CGA10 

CGA9 

CGA8 

CGA7 

CGA6 

CGA5 

CGA4 

CGA3 

DLYCHAR* 

DLYCHAR 

VOUT* 


MAX. 

CAPACITANCE 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

o 


Jl^&b. 
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ARRAY*:     4.4.0 

CIRCUIT  NAME:  Floppy  Disk  Support 

NO.  OF  PINS:      24 

MAX.  CLOCK  FREQ.:      8  MHz 

MAX.  PROP.  DELAY  THROUGHPUT:      75  ns 

OPER.TEMP:     0°Cto70°C 

OPERATING  VOLTAGE  &  RANGE:      5  V  ±  5% 
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4.  4. if 


Dl 
D2 
D3 
D5 
D6 
D7 

RESET* 
WRNMI* 
RDNMI* 
DRVSEL* 

INTRQ 

DRQ 

WG 


8MHZ 
ENP/RDY 

MOTORON 
EXTSEL 

NMI 
WAIT 


XTAL€f 

^L,  16MHZ 
T"  XTAL 


o 


XTAL1 


24  PIN  CHIP 


FLOPPY  DISK  SUPPORT 
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INTRQ 

© 

DRQ 

© 

ENP/RDY 

© 

WG 

© 

DO 

© 

Dl 

© 

D2 

© 

D3 

© 

D5 

© 

D6 

0 

D7 

<Q> 

GND 

a 

vcc 

XTAI*J0f 

XTAL1 

MOTORON 

EXT  S  EL 

NMI 

WAIT 

WRNMI* 

RDNMI* 

DRVSEL* 

8MHZ 

RESET* 
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SPEC. 

PARAMETER  MIN                        TYP                        MAX  UNITS 

1.  Data  Setup  Time  560  ns 

2.  Data  Hold  Time  50  n* 

3.  Reset*  Pulse  Width  70  100  JUS 

4.  Reset*  4-  to  Wait  or  NMI  i  75  ns 

5.  WRIMMI*  t  to  74LS74  Q's  Outputs  It  75  ns 

6.  DRVSEL*  ItoMOTORON  t  75  ns 
*7.  MOTORON  Pulse  Width  (Low!  3                           4                                  5  Mb 

8.  DRVSEL*  I  to  WAIT  t  75  AS 

9.  DRVSEL*  ItoCLRWAIT  t  500  1100  ns 

10.  DRVSEL*  itoWAITlMOUT  t  1024  1050  jus 

11.  DRVSEL*  t  to  ENP/RDYtJ-  75  m 

12.  DRVSEL*  t  to  EXTSEL  U  75  m 

13.  INTRQ  tor  DRQ  f  to  WAIT  4  75  m 

14.  INTRQ  tor  DRQ  ttoCLRWAIT  i  75  ns 

15.  INTRQ  tor  DRQ  ttoWAITIMOUT  I  75  ns 

16.  8  MHZ  Cycle  Time  125  ns 

17.  8  MHZ  Pulse  Width  (Low)  50  62.6  ns 

18.  8  MHZ  Pulse  Width  (High)  50  62.5  ns 

19.  WG  tl-to  ENP/RDY  U  75  ns 

20.  RDNMI*  4toD0,  D5-D7  Valid  76  ns 

21.  RDMMI*  ttoD0,  D5-D7  Tristate  0  75  ns 

MOTORON  Circuit  Must  Simulate  a  Retriggerable  Monostable  Multivibrator  (74LS123) 
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CAPACITANCE  LOAD 

OUTPUT  CAPACITANCE  MAX. 

D0  80  pf 

D5  80  pf 

D6  80  pf 

D7  80  pf 

8  MHZ  15pf 

ENP/RDY  15pf 

MOTORON  15pf 

EXTSEL  15pf 

NMI  15  pf 

WAIT  15  pf 
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PARAMETER 


DC  CHARACTERISTICS  0°  -  70°  C 
{ALL  PINS) 


MIN. 


TYP. 


MAX. 


UNITS 


Input  Voltage  Level  (High) 

2.0 

V 

Input  Voltage  Level  (Low) 

A 

V 

Output  Voltage  Level  (High) 

2.7 

3.5 

V 

Output  Voltage  Level  (Low) 

.35 

.5 

V 

(ALL  PINS  EXCEPT  MOTORON  &  D0,  D5-D7) 


Input  Current  Level  (High) 
Input  Current  Level  (Low) 


20 
-.4 


Output  Current  Level  (High) 

-160 

Output  Current  Level  (Low) 

3.2 

MOTORON 

Output  Current  Level  (High) 

-240 

Output  Current  Level  (Low) 

4.8 

D0,  05  D7 

Input  Current  Level  (High) 

Input  Current  Level  (Low) 

Output  Current  Level  (High) 

-280 

Output  Current  Level  (Low) 

5.6 

ma 
ma 


*» 


20 

*« 

-.4 

ma 

m 

ma 
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ARRAY*:      4.5.0 

CIRCUIT  NAME:      RS232  Support 

NO.  OF  PINS:     40 

OPER.  TEMP.:      0°Cto70°C 

OPER.  VOLTAGE:      5V±  5% 
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vcc 


AO 

1 

Al 

2 

3 

RDINTSTATUS 

4 

WRINTMASKREG 

5 

RS232IN 

6 

RS2320UT 

14 

CTS 

15 

DSR 

CD" 

16 

RI 

20 

RD 

13 

PE 

26 

FE 

25 

DE 

24 

THRE 

22 

DR 

19 

RTCIN 

36 

XINT 

35 

WR 

39 

N.    C. 


11 


4.5.0 
40    PIN 


10 

DTR 

7 

SRTS 

8 

ENTD 

21 

OUTE8 

38 

OUTE9 

11 

OUTEA 

23 

OUTEB 

18 

INEB 

RTS 


37 


INT 


27 

BDQr 

28 

BD1 

29 

BD2 
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AO-Al 


T 


VALID 
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Tl 
T2 


WRINTIMASKREG , 
RD I NT STATUS, 


RS232IN,  RS2320UT 


WR 
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BDBUS 
(OUT) 


BDBUS 
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QUTXX 
OUTXX 
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T4  h 


C 


T5 


■4  V- 


■*  *■ 


T6 


T13 


1       *" 


■i     h 


VALID 


■i     b 


X 


/ 


T7 
T8 


> 


i — 


-« T12 

Til 


T9 


T10~^ 


*  V- 


{ 


VALID 


} 


— Y — '  ^ 

— a — ,  h 


VALID 


Hardware  193 


MIN. 

TYP. 

MAX. 

t1 

168 

t2 

168 

t3 

-34 

0 

U 

-34 

0 

t5 

75 

t6 

75 

t7 

34 

t8 

60 

tg 

24 

250 

tio 

24 

250 

t11 

75 

ti2 

75 

t!3 

75 

t!4 

32 

o 


(Need  18) 


All  Timing  in  NSEC. 
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Index 


Subject 


Page     Subject 


Page 


9 


z> 


9 


Address  decoding 

4    3 

4  Gate  Array  26 

4P   60 

4P  Gate  Array 1 05 

Baud 

4    15 

4  Gate  Array  51 

4P    98 

4P  Gate  Array 142 

Baud  rate  generator 

4    15 

4  Gate  Array  51 

4P    57,  98 

4P  Gate  Array 142 

Buffering 

4  Gate  Array  48 

4P    95 

4P  Gate  Array 140 

CASIN* 

4    3,  17 

4  Gate  Array  54 

CASOUT* 

4    3,  16 

4  Gate  Array  54 

Cassette  circuitry 

4    9 

4  Gate  Array  46 

Clock 

4    3 

4  Gate  Array  21 

4P    57 

4P  Gate  Array 103 

Compensated  write  data 

4    17 

4  Gate  Array  47 

4P    96 

4P  Gate  Array 141 

Contrdller,  CRT 

4    7 

4  Gate  Array  21 ,  28,  36 

4P   57,  60,  85 

4P  Gate  Array 103,  105,  130 

Controller,  Floppy  Disk 

4  Gate  Array  48 

4P    93 

4P  Gate  Array 138 

CPU  Board 

4    3 

4  Gate  Array  21 

4P    57 

4P  Gate  Array 103 


CRT 

4    7,  9 

4  Gate  Array  21 ,  28,  36 

4P   57,  60,  85 

4P  Gate  Array 103,  105,  130 

Decoding,  address 

4    3 

4  Gate  Array  28 

4P   60 

4P  Gate  Array 105 

Disk  Drive 

4  Gate  Array   48 

4P    93 

4P  Gate  Array 142 

Drive  select 

4    17 

4  Gate  Array  47,  48 

4P    93,  95 

4P  Gate  Array 142 

DRVSEL* 

4    17 

4  Gate  Array  47 

4P    95 

4P  Gate  Array 140 

FDC  Controller 

4  Gate  Array  47,  48 

4P    93 

4P  Gate  Array 138 

I/O  bus 

4    14 

4  Gate  Array  44 

4P    91 

4P  Gate  Array 1 36 

Interrupts 

4  Gate  Array  48 

4P    95 

4P  Gate  Array 140 

Keyboard 

4    7 

4  Gate  Array  41 

4P    87 

4P  Gate  Array 1 32 

Memory  address  decoding 

4    6 

4  Gate  Array   27 

4P   60 

4P  Gate  Array 105 

MODOUT 

4    16 

4P    82 

4P  Gate  Array 127 


Index 


Subject  Page 

NMI  logic 

4  Gate  Array  48 

4P    95 

4P  Gate  Array 140 

Oscillator 

4    3,  5 

PAL  Circuits 

4    15 

Port  Address  decoding 

4    15 

4P    81 

4P  Gate  Array 126 

Port  bit  map 

4    6,  16 

4  Gate  Array  37 

4P    81 

4P  Gate  Array 126 

Precompensation,  write 

4  Gate  Array  47 

4P    96 

4P  Gate  Array 141 

Printer  status 

4    9 

4  Gate  Array   41 

4P    87 

4P  Gate  Array 132 

RAM 

4    7,  8 

4  Gate  Array  36,  39 

4P    71-84 

4P  Gate  Array 1 1 6-129 

RDINSTATUS* 

4    16 

4  Gate  Array  48 

4P    83 

4P  Gate  Array 128 

RDNMISTATUS* 

4    16 

4  Gate  Array  48 

4P    83 

4P  Gate  Array 128 

Real  Time  Clock 

4    9 

4  Gate  Array  41 

4P    87 

4P  Gate  Array 132 

ROM 

4     7 

4  Gate  Array   36 

4P    60 

4P  Gate  Array 105 


Subject 


Page 


RS-232  Board 

4  Gate  Array  51 

4P    98 

4P  Gate  Array 142 

Sound 

4    10 

4  Gate  Array   44 

4P    91 

4P  Gate  Array 136 

Timing,  CPU 

4    3 

4  Gate  Array  21 

4P    57 

4P  Gate  Array 1 03 

Video  Controller 

4    7 

4  Gate  Array  21 ,  28,  36 

4P   57,  60,  85 

4P  Gate  Array 103,  105,  130 

Video  Monitor 

4    7,  9 

4  Gate  Array  21 ,  28,  36 

4P    57,  60,  85 

4P  Gate  Array 103,  105,  130 

Wait  State 

4  Gate  Array  47 

4P    95 

4P  Gate  Array 140 

WRINTMASKREG* 

4    16 

4  Gate  Array  48 

4P    83 

4P  Gate  Array 128 

Write  Precompensation 

4  Gate  Array  47 

4P   96 

4P  Gate  Array 141 

WRNMIMASKREG* 

4    16 

4  Gate  Array   48 

4P    83 

4P  Gate  Array 128 
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SEMICONDUCTORS 

3501  ED  BLUESTEIN  BLVD  ,  AUSTiN,  TEXAS  78721 


Advance  Information 


CRT  CONTROLLER  (CRTC) 

The  MC6835  is  a  ROM  based  CRT  Controller  which  interfaces  an 
MPU  system  to  a  raster  scan  CRT  display.  It  is  intended  for  use  in  MPU 
based  controllers  for  CRT  terminals  in  stand-alone  or  cluster  configura- 
tions. The  MC6835  supports  two  selectable  mask  programmed  screen 
formats  using  the  program  select  input  (PROG). 

The  CRTC  is  optimized  for  the  hardware/software  balance  required 
for  maximum  flexibility.  All  keyboard  functions,  reads,  writes,  cursor 
movements,  scrolling,  and  editing  are  under  processor  control.  The 
mask  programmed  registers  of  the  CRTC  are  programmed  to  control 
the  video  format  and  timing. 

•  Cost  Effective  ROM  Based  CRTC  Which  Supports  Two  Screen 
Formats 

•  Useful  in  Monochrome  or  Color  CRT  Applications 

•  Applications  Include  "Glass-Teletype,"  Smart,  Programmable,  Intel- 
ligent CRT  Terminals;  Video  Games;  Information  Displays 

•  Alphanumeric,  Semigraphic,  and  Full  Graphic  Capability 

•  Timing  May  Be  Generated  for  Almost  Any  Alphanumeric  Screen 
Format,  e.g.,  80x24,  72x64,  132x20 

•  Single  +5  Volt  Supply 

•  M6800  Compatible  Bus  Interface 

•  TTL-Compatible  Inputs  and  Outputs 

•  Start  Address  Register  Provides  Hardware  Scroll  (By  Page,  Line,  or 
Character} 

•  Programmable  Cursor  Register  Allows  Control  of  Cursor  Position 

•  Refresh  (Screen)  Memory  May  Be  Multiplexed  Between  the  CRTC 
and  the  MPU  Thus  Removing  the  Requirements  for  Line  Buffers  or 
External  DMA  Devices 

•  Mask  Programmable  Interlace  or  Non-lnterlace  Scan  Modes 

•  14-Bit  Refresh  Address  Allows  Up  to  16K  of  Refresh  Memory 
for  Use  in  Character  or  Semigraphic  Displays 

•  5- Bit  Row  Address  Allows  up  to  32  Scan-Line  Character  Blocks 

•  By  Utilizing  Both  the  Refresh  Addresses  and  the  Row  Addresses, 
a  51 2K  Address  Space  is  Available  for  Use  in  Graphics  Systems 

•  Refresh  Addresses  are  Provided  During  Retrace,  Allowing  the  CRTC 
to  provide  Row  Addresses  to  Refresh  Dynamic  RAMs 

•  Pin  Compatible  with  the  MC6845.  The  MC6845  May  Be  Used  as  a 
Prototype  Part  to  Emulate  the  MC6835. 


MAXIMUM  RATINGS 


Rating 

Symbol 

Value 

Unit 

Supply  Voltage 

vcc- 

-0.3  to  +7.0 

V 

Input  Voltage 

Vin' 

-0.3  to  +7.0 

V 

Operating  Temperature  Range 
MC6835,  MC68A35,  MC68B35 
MC6836C,  MC68A35C,  MC6SB35C 

TA 

0  to  +70 
-SOto+85 

°c 

Storage  Temperature  Range 

Tstg 

-55  to  +150 

°c 

"With  respect  to  GND  (Vssl. 


MC6835 


MOS 

(HIGH-DENSITY,  N-CHANNEL, 
SILICON-GATE  DEPLETION  LOAD) 

MASK  PROGRAMMED 

CRT  CONTROLLER 

<CRTC> 


L  SUFFIX 

CERAMIC  PACKAGE 
CASE  715 


S  SUFFIX 

CERDIP  PACKAGE 
CASE  734 


P  SUFFIX 

PLASTIC  PACKAGE 
CASE  711 


PIN 


GND[  i 


ASSIGNMENT 


beset! 

PROG[ 
MAO  I 
MA1[ 
MA2I 
MA3(    7 
MA4(  8 
MA5[  9 
MA6[  10 
MA7[  II 
MA8[  12 
MA9|  13 
MA10|  14 
MAUI  15 
MA12(  16 
MA13(  17 
DEI  <6 
CURSOR  I  19 
VCc  I  20 


]vs 

]HS 
]RA0 
]RA1 
]RA2 
]RA3 
]RA4 
33  ]D0 
32  ]D1 
31  ]D2 
30  ]D3 
29  JD4 
28  ]D5 
27  JD6 
26  ]D7 
25ICS 
24  ]RS 
23  ]E 
22  ]W 
21  1CLK 
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MC6835 


DC  ELECTRICAL  CHARACTERISTICS  (Vcc  =  5  0Vdc  ±5%.  Vss  =  0,  TA  =  0  to  70°C  unless  otherw.se  noted)  (Reference  Figures  2  A) 


Characteristic 

Symbol 

Min 

TYP 

Max 

Unit 

Input  High  Voltage 

V|H 

20 

- 

vcc 

V 

Input  Low  Voltage 

V|L 

-03 

_ 

08 

V 

Input  Leakage  Current 

lin 

- 

01 

25 

*A 

Hi  Z  (0(f  Stale!  Input  Current  (Vcc  =  5  25  VI  IVm  =  0  4  to  2  4  VI 

'TSI 

-10 

- 

10 

MA 

Output  High  Voltage 
l'Load=-100cAI 

24 

30 

- 

V 

Output  Low  Voltage  <l|0a<j  -  1  6  mA) 

vol 

- 

03 

04 

V 

Internal  Power  Dissipation  (Measured  at  T^  =  0°C) 

pd 

- 

150 

300 

mW 

Input  Capacitance                                                                                                                         D0-D7 

All  Others 

Cm 

- 

- 

12  5 

pF 

- 

- 

10 

Output  Capacitance                                                                                                               All  Outputs 

C0ut 

- 

- 

10 

pF 

BUS  TIMING  CHARACTERISTICS  I  Reference  Figures  2  and  3) 


Ident 
Number 

Characteristics 

Symbol 

MC6835 

MC68A35 

MC68B35 

Unit 

Mm 

Max 

Mm 

Max 

Mm 

Max 

1 

Cycle  Time 

'eye 

1  0 

10 

0  67 

10 

05 

10 

pb 

2 

Pulse  Widlh    £  Low 

PWEL 

430 

- 

280 

- 

210 

- 

ns 
ns 

3 

Pulse  Width,  E  High 

PWEH 

450 

- 

280 

- 

220 

- 

4 

Clock  Transition  Time 

V.  If 

- 

25 

- 

25 

- 

20 

ns 

9 

Address  Hold  Time  (RS) 

'AH 

10 

- 

10 

- 

10 

- 

ns 

13 

RS  Setup  Belore  E 

tAS 

SO 

- 

60 

- 

40 

ns 

11 

Wand  CS  Selup  6e(ore  £ 

'CS 

80 

- 

60 

_ 

40 

- 

ns 

15 

Hold  Time  lor  w  and  CS 

'CH 

10 

- 

10 

- 

10 

- 

ns 

21 

Write  Data  Hold  Time  Required 

'DHW 

10 

- 

10 

- 

10 

- 

ns 

3) 

Peripheral  Input  Data  Selup 

'DSW 

165 

- 

80 

- 

60 

- 

ns 

*© 
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FIGURE  2  -  MC6835  BUS  TIMING 
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W",  CS" 


Write  Data 
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MPU  Write  Data 
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€> 
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1  Voltage  levels  shown  are  V|_  <0  4  V,  Vh  a  2  4  V  unless  otherwise  noted 

2  Measurement  points  shown  are  0  8V  and  20V  unless  otherwise  noted 
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FIGURE  3  -  BUS  TIMING  TEST  LOAD 
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CRTC  TIMING  CHARACTERISTICS  (See  Figure  4) 


FIGURE  4  -  CRTC  TIMING  CHART 
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Characteristics 

Symbol 

MC6835 

MC68A35 

MC68B35 

Unit 

Mm 

Max 

Min 

Max 

Min 

Max 

Minimum  Clock  Pulse  Width,  Low 

PWCL 

150 

- 

140 

- 

130 

- 

ns 

Minimum  Clock  Pulse  Width,  High 

PWCH 

150 

- 

140 

- 

130 

- 

ns 

Clock  Frequency 

fC 

330 

- 

300 

- 

270 

- 

ns 

Rise  and  Fall  Time  for  Clock  Input 

'r-  «f 

- 

20 

- 

20 

- 

20 

ns 

Memory  Address  Delay  Time 

'MAD 

- 

160 

- 

160 

- 

160 

ns 

Raster  Address  Delay  Time 

'RAD 

- 

160 

- 

160 

- 

160 

ns 

Display  Timing  Delay  Time 

'DTO 

- 

250 

- 

250 

- 

200 

ns 

Horizontal  Sync  Delay  Time 

'HSD 

- 

250 

- 

250 

- 

200 

ns 

Vertical  Sync  Delay  Time 

'VSP 

- 

250 

- 

250 

- 

200 

ns 

Cursor  Display  Timing  Delay  Time 

<CDD 

- 

250 

- 

250 

- 

200 

ns 

C*y 


NOTE   Timing  measurements  are  referenced  to  and  from  a  low  voltage  of  0  8  volts  and  a  high  voltage  o'  2  0  volts  unless  otherwise  noted 
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CRTC  INTERFACE  SYSTEM  DESCRIPTION 


The  MC6835  CRT  Controller  generates  the  signals 
necessary  to  interface  a  digital  system  to  a  raster  scan  CRT 
display  In  this  type  of  display,  an  electron  beam  starts  in  the 
upper  left  hand  corner,  moves  quickly  across  the  screen  and 
returns  This  action  is  called  a  horizontal  scan  After  each 
horizontal  scan  the  beam  is  incrementally  moved  down  in  the 
vertical  direction  until  it  has  reached  the  bottom  At  this 
point  one  frame  has  been  displayed,  as  the  beam  has  made 
many  horizontal  scans  and  one  vertical  scan 

Two  types  of  raster  scanning  are  used  in  CRTs,  interlace 
and  non-interlace,  shown  in  Figures  5  and  6  Non-interlacing 
scanning  consists  of  one  field  per  frame  The  scan  lines  in 
Figure  5  are  shown  as  solid  lines  and  the  retrace  patterns  are 
indicated  by  the  dotted  lines  Increasing  the  number  of 
frames  per  second  will  decrease  the  flicker  Ordinarily,  either 
a  50  or  60  frame  per  second  refresh  rate  is  used  to  minimize 
beating  between  the  frequency  of  the  CRT  horizontal 
oscillator  and  the  power  line  frequency  This  prevents  the 
displayed  data  from  weaving  or  swimming 

Interlace  scanning  is  used  in  broadcast  TV  and  on  data 
monitors  where  high  density  or  high  resolution  data  must  be 
displayed  Two  fields,  or  vertical  scans  are  made  down  the 
screen  for  each  single  picture  or  frame  The  first  field  (Even 


field)  starts  in  the  upper  left  hand  corner,  the  second  (Odd 
field)  in  the  upper  center  Both  fields  overlap  as  shown  in 
Figure  6,  thus  interlacing  the  two  fields  into  a  single  frame 

In  order  to  display  the  characters  on  the  CRT  screen  the 
frames  must  be  continually  repeated  The  data  to  be 
displayed  is  stored  in  the  Refresh  (Screen)  memory  by  the 
MPU  controlling  the  data  processing  system  The  data  is 
usually  written  in  ASCII  code,  so  it  cannot  be  directly 
displayed  as  characters  A  Character  Generator  ROM  is 
typically  used  to  convert  the  ASCII  codes  into  the  "dot"  pat- 
tern for  every  character 

The  most  common  method  of  generating  characters  is  to 
create  a  matrix  of  "x"  dots  (columns)  wide  and  "y"  dots 
(rows)  high  Each  character  is  created  by  selectively  filling  in 
the  dots  As  "x"  and  "y"  get  larger  a  more  detailed  character 
may  be  created  Two  common  dot  matrices  are  5x7  and 
7x9  Many  variations  of  these  standards  will  allow  Chinese, 
Japanese,  or  Arabic  letters  instead  of  English  Since 
characters  require  some  space  between  them,  a  character 
block  larger  than  the  character  is  typically  used  as  shown  in 
Figure  7  The  figure  also  shows  the  corresponding  timing 
and  levels  for  a  video  signal  that  would  generate  the 
characters 


FIGURE  6  -  RASTER  SCAN  SYSTEM  (NON-INTERLACE) 
■  Active  Display 
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FIGURE  6  -  RASTER  SCAN  SYSTEM  (INTERLACE) 


■  Even  Number  Field  (First) 


— —  —  Odd  Number  Field  (Second I 
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FIGURE  7  -  CHARACTER  DISPLAY  ON  THE  SCREEN  AND  VIDEO  SIGNAL 
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Referring  to  Figure  1,  the  MC6835  CRT  controller 
generates  the  Refresh  addresses  (MA0-MA13K  row  ad- 
dresses (RA0-RA4),  and  the  video  timing  (vertical  sync  - 
VS,  horizontal  sync  —  HS  and  display  enable  -  DEI  Other 
functions  include  an  internal  cursor  register  which  generates 
a  Cursor  output  when  us  contents  compare  to  the  current 
Refresh  address  A  select  input.  PROG,  allows  selection  of 
One  of  two  mask  programmed  video  formats  (e  g  ,  for  50  Hz 
and  60  Hz  compatibility! 

All  timing  in  the  CRTC  is  derived  from  the  CLK  input  In 
alphanumeric  terminals,  this  signal  is  the  character  rate  The 
video  rate  or  "dot"  clock  is  externally  divided  by  high  speed 
logic  (TTL)  to  generate  the  CLK  signal  The  high  speed  logic 
must  also  generate  the  timing  and  control  signals  necessary 
for  the  Shift  Register,  Latch  and  MUX  Control  shown  in 
Figure  1 

The  processor  communicates  with  the  CRTC  through  an 
8-bit  data  bus  by  writing  into  the  five  user  programmable 
registers  of  the  MC6835 

The  Refresh  memory  address  is  multiplexed  between  the 
processor  and  the  CRTC  Data  appears  on  a  secondary  bus 
separate  from  the  processor's  bus  The  secondary  data  bus 
concept  in  no  way  precludes  using  the  Refresh  RAM  for 
other  purposes  It  looks  like  any  other  RAM  to  the  processor 
A  number  of  approaches  are  possible  for  solving  contentions 
for  the  Refresh  memory 

1     Processor  always  gets  priority   (Generally,  "hash"  oc- 
curs as  MPU  and  CRTC  clocks  are  not  synchronized  ) 


!  Processor  gets  priority  access  anytime,  but  can  be 
synchronized  by  an  interrupt  to  perform  accesses  only 
during  horizontal  and  vertical  retrace  times 

I  Synchronize  the  processor  with  memory  wait  cycles 
(states) 

\  Synchronize  the  processor  to  the  character  rate  as 
shown  in  Figure  8  The  M6800  processor  family  works 
very  well  in  this  configuration  as  constant  cycle 
lengths  are  present  This  method  provides  no 
overhead  for  the  processor  as  there  is  never  a  conten- 
tion tor  a  memory  access  All  accesses  are 
transparent 

FIGURE  8  -  TRANSPARENT  REFRESH  MEMORY 
CONFIGURATION  TIMING  USING  M6800  FAMILY  MPU 
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PIN  DESCRIPTION 

PROCESSOR  INTERFACE 

The  CRTC  interfaces  to  a  processor  bus  on  the  data  bus 
(D0-D7)  using  CS,  RS,  E,  and  W  for  control  signals 


Data  Bus  (DO-D7I 

write  only  data  bus 


The  data  lines  (DO  D7)  comprise  the 


Enable  (E)  -  The  Enable  signal  is  a  high-impedance 
TTL/MOS-compatible  input  which  enables  the  data  bus  in- 
put/output buffers  and  clocks  data  to  the  CRTC  This  signal 
is  usually  derived  from  the  processor  clock  The  high  to  low 
transition  is  the  active  edge 

Chip  Select  (CS)  -  The  CS  line  is  an  active-low  high- 
impedance  TTL/MOS-compatible  input  which  selects  the 
CRTC  write  to  the  internal  register  file  This  signal  should 
only  be  active  when  there  is  a  valid  stable  address  being 
decoded  from  the  processor 

Register  Select  (RS)  -  The  RS  line  is  a  high-impedance 
TTL/MOS-compatible  input  which  selects  either  the  Ad- 
dress Register  (RS  =  "0")  or  one  of  the  Data  Registers 
IRS  =  "1")  of  the  internal  register  file  when  CS  is  low 

Write  (W)  —  The  W  line  is  a  high-impedance  TTL/MOS- 
compatible  input  which  determines  whether  the  internal 
register  file  gets  written   A  write  is  defined  as  a  low  level 

CRT  CONTROL 

The  CRTC  provides  horizontal  sync  (HSI,  vertical  sync 
(VSI,  and  display  enable  (DE)  signals 

NOTE  -  Care  should  be  exercised  when  interfacing  to 
CRT  monitors  as  many  monitors  claiming  to  be  "TTL  com- 
patible," have  transistor  input  circuits  which  require  the 
CRTC  or  TTL  devices  buffering  signals  from  the  CRTC/video 
circuits  to  exceed  the  maximum  rated  drive  currents 

Vertical  Sync  (VS)  and  Horizontal  Sync  (HS)  -  These 
TTL-compatible  outputs  are  active-high  signals  which  drive 
the  monitor  directly  or  are  fed  to  the  video  processing  cir- 
cuitry to  generate  a  composite  video  Signal  The  VS  signal 
determines  the  vertical  position  of  the  displayed  text  while 
the  HS  signal  determines  the  horizontal  position  of  the 
displayed  text 

Display  Enable  (DE)  -  This  TTL-compatible  output  is  an 
active-high  signal  which  indicates  the  CRTC  is  providing  ad- 
dressing in  the  active  Display  Area 

REFRESH     MEMORY/CHARACTER    GENERATOR    AD- 
DRESSING 

The  CRTC  provides  Memory  Addresses  IMA0-MA13I  to 
scan  the  Refresh  RAM  Row  Addresses  IRA0-RA4)  are  also 
provided  lor  use  with  character  generator  ROMs  In  a 
graphics  system  both  the  Memory  Addresses  and  the  Row 
Addresses  would  be  used  to  scan  the  Refresh  RAM    Both 


the  Memory  Addresses  and  the  Row  Addresses  continue  to 
run  during  vertical  retrace  thus  allowing  the  CRTC  to  provide 
the  refresh  addresses  required  to  refresh  dynamic  RAMs 

Refresh  Memory  Addresses  (MA0-MA13)  -  These  14  out- 
puts are  used  to  refresh  the  CRT  screen  with  pages  of  data 
located  within  a  16K  block  of  refresh  memory  These  outputs 
are  capable  of  driving  one  standard  TTL  load  and  30  pF 

Row  Addresses  (RA0-RA4)  —  These  five  outputs  from  the 
internal  Row  Address  counter  are  used  to  address  the 
Character  Generator  ROM  These  outputs  are  capable  of 
driving  one  standard  TTL  load  and  30  pF 

OTHER  PINS 

Cursor  -  This  TTL-compatible  output  indicates  a  valid 
Cursor  address  to  external  video  processing  logic  It  is  an 
active-high  signal 

Clock  (CLK)  -  The  CLK  is  a  TTL/MOS-compatible  input 
used  to  synchronize  all  CRT  functions  except  for  the  pro- 
cessor interface  An  external  dot  counter  is  used  to  derive 
this  signal  which  is  usually  the  character  rate  in  an 
alphanumeric  CRT   The  active  transition  is  high-to-low 

Program  Select  (PROG)  -  This  TTL-compatible  input 
allows  selection  of  one  of  two  sets  of  mask  programmed 
video  formats  Set  2ero  is  selected  when  PROG  is  low  and 
set  one  is  selected  when  PROG  is  high 

Vcc,  GND  -  These  inputs  supply  +5  Vdc  ±5%  to  the 
CRTC 


RESET  -  The  RESET  input  is  used  to  reset  the  CRTC 
Functionality  of  RESET  differs  from  that  of  other  M6800 
parts  RESET  must  remain  low  for  at  least  one  cycle  of  the 
character  clock  (CLK)  A  low  level  on  the  RESET  input 
forces  the  CRTC  into  the  following  state 

a     All  counters  in  the  CRTC  are  cleared  and  the  device 

stops  the  display  operation 
b     All  the  outputs  are  driven  low,  except  the  MA0-MA13 
outputs  which  are  driven  to  the  current  value  in  the 
Start  Address  Register 
C     The  control  registers  of  the  CRTC  are  not  affected  and 

remain  unchanged 
d     The  CRTC  resumes  the  display  operation  immediately 
after  the  release  of  RESET 


CRTC  DESCRIPTION 

The  CRTC  consists  of  mask-programmable  horizontal  and 
vertical  timing  generators,  software-programmable  linear  ad- 
dress register,  mask-programmable  cursor  logic  and  control 
circuitry  for  interfacing  to  a  M6800  family  microprocessor 
bus 

All  CRTC  timing  is  derived  from  CLK,  usually  the  output  of 
an  external  dot  rate  counter  Coincidence  (CO)  circuits  con- 
tinuously compare  counter  contents  to  the  contents  of  the 
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TABLE  1  -  INTERNAL  REGISTER  ASSIGNMENT 


cs 

RS 

Address  Register 

Register 

1 

Register  File 

Program 
Unit 

Read 

Write 

Number  of  Bits 

4 

3 

2 

1 

0 

71 

6 

5 

4 

3 

2 

1 

0 

1 

X 

X 

X 

X 

X 

X 

X 

- 

- 

- 

5\v^\^ 
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0 

X 

X 

X 

X 

X 

AR 

Address  Register 
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No 

Yes 

sss 

\    Note  3    / 

RO 

Horizontal  Total 

Char 

No 

No 

R1 

Horizontal  Displayed 

Char 

No 

No 

R2 

H    Sync  Position 

Char 

No 

No 

R3 

Sync  Width 

- 

No 

No 

V 

V 

V 

V 

H 

H 

H 

H 

R4 

Vertical  Total 

Char   Row 

No 

No 

^ 

R5 

V   Total  Adiusi 

Scan  Line 

No 

No 

5^ 

R6 

Vertical  Displayed 

Char   Row 

No 

No 

^ 

R7 

V    Sync  Position 

Char    Row 

No 

No 

■\ 

R8 

Interlace  Mode  and  Skew 

Note  1 

No 

No 

C 

C 

D 

D 

I 

I 

R9 

Max  Scan  Line  Address 

Scan  Line 

No 

No 

5s 

RIO 

Cursor  Start 

Scan  Line 

No 

No 

B 

P 

(Note  2) 

R11 

Cursor  End 

Scan  Line 

No 

No 

s 

\ 

0 

1 

0 

1 

1 

0 

0 

R12 

Stan  Address  (HI 

- 

No 

Yes 

0 

0 

0 

1 

0 

1 

1 

0 

1 

R13 

Start  Address  (L) 

- 

No 

Yes 

0 

1 

0 

1 

1 

1 

0 

R14 

Cursor  (HI 

- 

No 

Yes 

0 

0 

0 

1 

0 

1 

1 

1 

1 

R15 

Cursor  (L) 

- 

No 

Yes 

NOTES 

1  The  Interlace  Control  is  shown  in  Table  2  while  Skew  Control  is  shown  in  Table  3 

2  Bit  5  of  the  Cursor  Start  Raster  Register  is  used  10  blink  period  control,  and  Bit  6  is  used  to  select  blink  or  non-blink 

3  R0-R11  are  mask-programmable  and  are  not  accessible  via  the  data  bus 
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mask  programmable  register  file,  R0-R11   For  horizontal  tim 
ing  generation,  comparisons  result  in 

1  Horizontal  sync  pulse  IHS)  of  a  frequency,  position 
and  width  determined  by  the  register  contents 

2  Horizontal  Display  signal  of  a  frequency,  position  and 
duration  determined  by  the  register  contents 

The  horizontal  counter  produces  H  clock  which  drives  the 
Scan  Line  Counter  and  Vertical  Control  The  contents  of  the 
Raster  Counter  are  continuously  compared  to  the  Max  Scan 
Line  Address  Register  A  coincidence  resets  the  Raster 
Counter  and  clocks  the  Vertical  Counter 

Comparisons  of  Vertical  Counter  contents  and  Vertical 
Registers  result  in 

1  Vertical  sync  pulse  (VS)  of  a  frequency,  position  and 
width  determined  by  the  register  contents 

2  Vertical  Display  signal  of  a  frequency,  position,  and 
duration  determined  by  the  register  contents 

The  Vertical  Control  Logic  has  other  functions 

1  Generate  row  selects,  RA0-RA4,  from  the  Raster 
Count  for  the  corresponding  interlace  or  non-interlace 
modes 

2  Extend  the  number  of  scan  lines  in  the  vertical  total  by 
the  amount  programmed  in  the  Vertical  Total  Adjust 
Register 

The  cursor  logic  determines  the  size  and  blink  rate  of  the 


cursor  as  indicated  by  the  register  contents 

The  Linear  Address  Generator  is  driven  by  CLK  and 
locates  the  relative  positions  of  characters  in  memory  and 
their  positions  on  the  screen  Fourteen  outputs,  MA0-MA13, 
are  available  for  addressing  up  to  four  pages  of  4K 
characters,  eight  pages  of  2K  characters,  etc 

Five  additional  write-only  registers  define  the  Start  Ad- 
dress and  cursor  position  Using  the  Start  Address  Register, 
hardware  scrolling  through  16K  characters  is  possible  The 
Linear  Address  Generator  repeats  the  same  sequence  of  ad- 
dresses for  each  scan  line  of  a  character  row  The  Start  Ad- 
dress Register  and  the  Cursor  Position  Register  are  program- 
med by  the  processor  through  the  data  bus,  D0-D7  and  the 
control  signals  -  W,  CS,  RS,  and  E    Refer  to  Figure  9 


REGISTER  FILE  DESCRIPTION 

The  MC6835  has  17  control  registers  of  which  12  are  mask 
programmable  The  remaining  five  registers  -  Address 
register.  Start  Address  register  pair,  and  Cursor  Position 
register  pair  —  are  write-only  registers  programmed  by  the 
MPU  These  registers  control  horizontal  timing,  vertical  tim- 
ing, interlace  operation,  row  address  operation  and  define 
the  cursor,  cursor  address,  and  start  address  The  register 
addresses  and  sizes  are  shown  in  Table  1 


o 


® 


MOTOROLA  Semiconductor  Products  Inc. 


<m 


FIGURE  9  -  CRTC  BLOCK  DIAGRAM 
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MASK  PROGRAMMABLE  REGISTERS  R0-R11 

The  twelve  mask  programmable  registers  determine  the 
display  format  generated  by  the  MC6835  The  PROG  input  is 
used  to  select  one  of  two  sets  of  register  values 

Figure  10  shows  the  visible  display  area  of  a  typical  CRT 
monitor  giving  the  point  of  reference  for  horizontal  registers 
as  the  left  most  displayed  character  position  Horizontal 
registers  are  programmed  in  character  clock  time  units  with 
respect  to  the  reference  as  shown  in  Figure  1 1  The  point  of 
reference  for  the  vertical  registers  is  the  lop  character  posi- 
tion displayed  Vertical  registers  are  programmed  in 
character  row  times  or  scan  line  times  as  shown  in  Figure  12 

Horizontal  Total  Register  (R0)  —  This  8-bit  register  deter- 
mines the  horizontal  sync  (HS)  frequency  by  defining  the  HS 
period  in  character  times  It  is  the  total  of  the  displayed 
characters  plus  the  non-displayed  character  times  (retrace) 
minus  one 

Horizontal  Displayed  Register  (R1)  -  This  8-bit  register 
determines  the  number  of  displayed  characters  per  line  Any 
8-bit  number  may  be  programmed  as  long  as  the  contents  of 
R0  are  greater  than  the  contents  of  R1 

Horizontal  Sync  Position  Register  (R2)  -  This  8-bit 
register  controls  the  HS  position  The  horizontal  sync  posi- 
tion defines  the  horizontal  sync  delay  (Front  Porch)  and  the 
horizontal  scan  delay  (Back  Porch)  When  the  programmed 
value  of  this  register  is  increased,  the  display  on  the  CRT 
screen  is  shifted  to  the  left  When  the  programmed  value  is 


decreased  the  display  is  shifted  to  the  right  Any  8-bit 
number  may  be  programmed  as  long  as  the  sum  of  the  con- 
tents of  R1,  R2,  and  the  lower  four  bits  of  R3  are  less  than 
the  contents  of  R0 

Sync  Width  Register  (R3)  -  This  8-bit  register  determines 

the  width  of  the  vertical  sync  (VS)  pulse  and  the  horizontal 
sync(HS)  pulse  Programming  the  upper  four  bits  for  1-to-15 
will  select  VS  pulse  widths  from  1-to-15  scan-line  times  Pro- 
gramming the  upper  four  bits  as  zeros  will  select  a  VS  pulse 
width  of  16  scan  line  times  The  HS  pulse  width  may  be  pro- 
grammed from  1-to-15  character  clock  periods  thus  allowing 
compatibility  with  the  HS  pulse  width  specifications  of  many 
different  monitors  If  zeros  are  written  into  the  lower  four 
bits  of  this  register,  then  no  HS  is  provided 

Horizontal  Timing  Summary  (Figure  11)  —  The  difference 
between  R0  and  R1  is  the  horizontal  blanking  interval  This 
interval  in  the  horizontal  scan  period  allows  the  beam  to 
return  (retrace)  to  1he  left  side  of  the  screen  The  retrace  time 
is  determined  by  the  monitor's  horizontal  scan  components 
Retrace  time  is  less  than  the  horizontal  blanking  interval  A 
good  rule  of  thumb  is  to  make  the  horizontal  blanking  about 
20%  of  the  total  horizontal  scanning  period  for  a  CRT  In  in- 
expensive TV  receivers,  the  beam  overscans  the  display 
screen  so  that  aging  of  parts  does  not  result  in  underscan- 
ning  Because  of  this,  the  retrace  time  should  be  about  1/3 
the  horizontal  scanning  period  The  horizontal  sync  delay, 
HS  pulse  width  and  horizontal  scan  delay  are  typically  pro- 
grammed with  1  2  2  ratio 
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FIGURE  10  -  ILLUSTRATION  OF  THE  CRT  SCREEN  FORMAT 
Number  of  Horizontal  Total  Char   (Nht-i- 11- 


-Number  of  Horizontal  Displayed  Char   INhdl- 


A"B=:C 


Display  Period 


Vertical  Retrace  Period 


Total  Scan  Line  Adiust  INadi)  — 

MOTE  1     Timing  values  are  described  in  Table  8 
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TABLE  4  -  CURSOR  AND  DE  SKEW  CONTROL 


Value 

Skew 

00 

No  Character  Skew 

01 

One  Character  Skew 

10 

Two  Character  Skew 

11 

Not  Available 

Maximum  Scan  Line  Address  Register  (R9)  -  This  5-bit 
register  determines  the  number  of  scan  lines  per  character 
row  including  the  spacing  thus  controlling  operation  of  the 
Row  Address  counter  The  programmed  value  is  a  maximum 
address  and  is  one  less  ihan  the  number  of  scan  lines 

Cursor  Start  Register  (R10)  and  Cursor  End  Register  (R11) 

These  registers  allow  a  cursor  of  up  to  32  scan  lines  in 
height  to  be  placed  on  any  scan  line  of  the  character  block  as 
shown  in  Figure  14  RIO  is  a  7  bit  register  used  to  define  the 
start  scan  line  and  blink  rate  for  the  cursor  Bits  5  and  6  of 
the  Cursor  Start  Address  Register  control  the  cursor  opera- 
tion as  shown  in  Table  4  Non-display,  display  and  two  blink 
modes  (16  times  or  32  times  ihe  field  period)  are  available 
R11  is  a  5-bit  register  which  defines  the  last  scan  line  of  the 
cursor 

When  an  external  blink  feature  on  characters  is  required,  it 
may  be  necessary  to  perform  cursor  blink  exiernally  so  thai 
both  blink  rates  are  synchronized  Note  that  an  invert/ non- 
invert  cursor  is  easily  implemented  by  programming  the 
CRTC  for  a  blinking  cursor  and  externally  inverting  the  video 
signal  with  an  exclusive-OR  gate 

PROGRAMMABLE  REGISTERS 

The  four  programmable  registers  allow  the  MPU  to  posi 


tion  the  cursor  anywhere  on  the  screen  and  allow  the  start 
address  to  be  modified 

The  Address  Register  is  a  five-bit  write-only  register  used 
as  an  "indirect"  or  "pointer"  register  Its  contents  are  the  ad- 
dress of  one  of  the  other  18  registers  When  both  RS_and  CS 
are  low,  the  Address  Register  is  selected  When  CS  is  low 
and  RS  is  high,  1he  register  pointed  to  by  the  Address 
Register  is  selected 

Start  Address  Register  (R12-H,  R13-L)  -  This  14-bit 
write-only  register  pair  controls  the  first  address  output  by 
the  CRTC  after  vertical  blanking  It  consists  of  an  8-bit  low 
order  IMA0-MA7I  register  and  a  6-bit  high  order  (MAS- 
MAIS)  register  The  start  address  register  determines  which 
portion  of  the  refresh  RAM  is  displayed  on  the  CRT  screen 
Hardware  scrolling  by  characler,  line  or  page  may  be  ac- 
complished by  modifying  the  contents  of  this  register 


Cursor  Register  (R14-H,  R15-L)  -  This  14-bit  write-only 
register  pair  is  programmed  to  position  the  cursor  anywhere 
in  the  refresh  RAM  area  thus  allowing  hardware  paging  and 
scrolling  through  memory  without  loss  o(  the  original  cursor 
position  It  consists  of  an  8-bit  low  order  (MA0-MA7)  register 
and  a  6-bit  high  order  (MA8-MA13)  register 

CRTC  INITIALIZATION 

Registers  R12-R15  must  be  initialized  after  the  system  is 
powered  up  The  processor  will  normally  load  the  CRTC 
register  file  from  a  firmware  table  Figure  15  shows  an  M6800 
program  which  could  be  used  to  program  the  CRT  Con- 
troller 
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FIGURE  14  -  CURSOR  CONTROL 


I    On"     I    oif     r 


On 


0- 
1- 
2- 
3- 
4- 
5- 
6- 
7- 
8- 
9- 
10- 
11- 


<HHXXXH> 


1< Blink  Period  = 

I  16  or  32  Times 

Field  Period 

Example  of  Cursor  Display  Mode 


Cursor  Start  Adr   =9 
Cursor  End  Adr  =  9 


Cursor  Start  Adr  -9 
Cursor  End  Adr   =  10 


Hi    1111 


;$S$3S3: 


mmmmO0 


9- 
10- 

11- 


asss;*:;* 


Cursor  Start  Adr   =  1 
Cursor  End  Adr  =  5 
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ADDITIONAL  CRTC  APPLICATIONS 

The  foremost  system  function  which  may  be  performed  by 
the  CRTC  controller  is  the  refreshing  of  dynamic  RAM  This 
is  quite  simple  as  the  refresh  addresses  continually  run 

Both  the  VS  and  the  HS  outputs  may  be  used  as  a  real 
time  clock  Once  programmed,  the  CRTC  will  provide  a 
stable  reference  frequency 

SELECTING  MASK  PROGRAMMED  REGISTER  VALUES 

A  prototype  system  may  be  developed  using  the  MC6845 
CRTC    This  will  allow  register  values  to  be  modified  as  re- 


quired to  meet  system  specifications  The  worksheet  of 
Table  5  is  extremely  useful  in  computing  proper  register 
values  for  the  MC6835  The  program  shown  in  Figure  15  may 
be  expanded  to  properly  load  the  calculated  register  values  in 
the  MC6845  Once  the  two  sets  of  register  values  have  been 
developed,  fill  out  the  ROM  program  worksheet  of  Figure  18 
To  order  a  custom  programmed  MC6835,  contact  your 
local  field  service  office,  local  sales  person  or  your  local 
Motorola  representative  A  manufacturing  mask  will  be 
developed  for  the  data  entered  in  Figure  18 


FIGURE  15  -  M6800  PROGRAM  FOR  CRTC  INITIALIZATION 
PAGE      001      CRTCINIT.SA: 1       MC6835    CRTC    initialization    program 


00001 

NAM 

MC6835 

00002 

TTL 

CRTC  ini 

00003 

OPT 

G,S,LLE= 

00004 

********************** 

00005 

*  Assign  CRTC 

address 

00006 

* 

00007 

9000 

A 

CRTCAD  EQu" 

$9000 

00008 

9001 

A 

CRTCRG  EQU 

CRTCAD+1 

00009 

********************** 

00010 

*  Initializat 

ion  Progr 

00011 

* 

00012A 

0000 

ORG 

0 

00013A 

0000 

C6 

0C 

A 

LDAB 

$C 

00014A 

0002 

CE 

1020 

A 

LDX 

38RTTAB 

00015A 

0005 

F7 

9000 

A 

CRTC1   STAB 

CRTCAD 

00016A 

0008 

A6 

00 

A 

LDAA 

0,X 

00017A 

000A 

B7 

9001 

A 

STAA 

CRTCRG 

00018A 

000D 

08 

INX 

00019A 

000E 

5C 

INCB 

00020A 

000F 

Dl 

10 

A 

CMPB 

$10 

00021A 

0011 

26 

F2  0005 

BNE 

CRTC1 

00022A 

0013 

3F 

SWI 

00023 

********************** 

00024 

*  CRTC  register  initia 

00025 

* 

00026A 

1020 

ORG 

$1020 

00027A 

1020 

0080 

A 

CRTTAB  FDB 

$0080 

00028A 

1022 

0080 

A 

FDB 

$0080 

00029 

END 

TOTAL  ERRORS 

00000  — 

00000 

tialization    program 

85    print    FCB'x,    FDB's    &    XREF    table 

********************************** 


Address  Register 
Data  Register 
********************************** 

am 

a  place  to  start 

initialize  pointer 

table  pointer 

load  address  register 

get  register  value  from  table 

program  register 

increment  counter 

finished? 

no:  take  branch 

yes:  call  monitor 
********************************** 

lization  table 

start  of  table 

R12,  R13  -  Start  Address 

R14,  R15  -  Cursor  Address 


CRTC1   0005   CRTCAD  9000   CRTCRG  9001   CRTTAB  1020 
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OPERATION  OF  THE  CRTC 


Timing  of  the  CRT  Interface  Signals  -  Timing  charts  of 
CRT  interface  signals  are  illustrated  in  (his  section  with  the 
aid  of  programmed  example  of  the  CRTC  When  values 
listed  in  Table  7  are  programmed  into  CRTC  control 
registers,  the  device  provides  the  outputs  as  shown  in  the 
Timing  Diagrams  (Figures  11,  12,  16,  and  17)    The  screen 


format  of  this  example  is  shown  in  Figure  10  Figure  17  is  an 
illustration  of  the  relation  between  Refresh  Memory  Address 
I  MAO  MA13I,  Raster  Address  IRA0-RA4)  and  the  position 
on  the  screen  In  this  example,  the  start  address  is  assumed 
to  be  "0" 


# 


® 


TABLE  7  -  VALUES  PROGRAMMED  INTO  CRTC  REGISTERS 


Register 

Number 

Register  Name 

Value 

Programmed 
Value 

RO 

H   Total 

Nht+1 

Nht 

Rl 

H   Displayed 

Nhd 

Nhd 

R2 

H    Sync  Position 

Nhsp 

Nhsp 

A3 

H    Sync  Width 

Nhsw 

Nhsw 

R4 

V    Total 

Nvt+1 

Nvt 

R5 

V   Scan  Line  Adjust 

Nadi 

Nadi 

R6 

V   Displayed 

Nvd 

Nvd 

R7 

V    Sync  Position 

Nvsp 

Nvsp 

R8 

Interlace  Mode 

R9 

Max  Scan  Line  Address 

Nsl 

Nsl 

RIO 

Cursor  Start 

R11 

Cursor  End 

R12 

Start  Address  (HI 

0 

R13 

Start  Address  (L) 

0 

R14 

Cursor  IH) 

R16 

Cursor  ILI 
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FIGURE  18  -  ROM  PROGRAM  WORKSHEET 


0 


The  value  in  each  register  of  the  MC6845  should  be  entered  without  any  modifications.  Motorola  will  take  care  of  translating  into  the  appropriate 
format. 

D  All  numbers  are  in  decimal.      O  All  numbers  are  in  hex. 


RO 
R1 
R2 
R3 
R4 
R5 
R6 
R7 
R8 
R9 
RIO 
R11 


ROM 

Program 

Zero 

<PROG  =  0) 


ROM 

Program 

One 

<PROG  =  1) 


N 


ORDERING  INFORMATION 


Package  Type 

Frequency  (MHz) 

Temperature 

Order  Number 

Ceramic 

1.0 

0°C  to  70°C 

MC6835L 

L  Suffix 

1.0 

-60°C  loS5°C 

MC6835CL 

1.5 

0°C  to  70°C 

MC68A35L 

1.5 

-50°C  io85°C 

MC68A35CL 

2.0 

0°C  to  70°C 

MC68B35L 

2.0 

-50°C  to85"C 

MC68B35CL 

Cerdip 

1.0 

0°C  to  70°C 

MC6835S 

S  Suffix 

1.0 

-  50"C  to  85°C 

MC6835CS 

15 

0°C  to  70°C 

MC68A35S 

1  5 

-  50°C  to  85°C 

MC68A35CS 

20 

0°C  to  70°C 

MC68B35S 

2.0 

-50°C  to85gC 

MC68B35CS 

Plastic 

1.0 

0°C  to  70°C 

MC6835P 

P  Suffix 

1.0 

-50°Cto85°C 

MC6835CP 

1.5 

0°C  to  70°C 

MC68A35P 

1.5 

-50°C  to85°C 

MC68A35CP 

2.0 

0°C  to  70°C 

MC68B35P 

20 

-50°C  to35°C 

MC68B35CP 

® 
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MC6835* 


PACKAGE  DIMENSIONS 


L  SUFFIX 

CERAMIC  PACKAGE 
CASE  716-0* 


DIM 

MILLIMETERS 

INCHES 

WIN 

MAX 

mm 

MAX 

A 

SO  29 

SI  31 

I960 

2  0tt 

> 

14  94 

ISM 

osu 

OSW 

C 

3  0! 

406 

D  120 

0  160 

D 

in 

0  53 

0015 

0  071 

F 

0  J6 

140 

0030 

ooss 

G 

2  54  0SC 

0100  BSC 

m 

OK 

wi 

0010 

0  070 

J 

020 

0  33 

OOOB 

0013 

K 

254 

419 

otoo 

0165 

I 

14  99 

IS  49 

0  590 

0610 

it 

- 

IO» 

_ 

10" 

N 

102 

is: 

0  040 

0  050 

NOTES 

1  LEADS  TRUE  POSITIONED  WITHIN  OH  mm 
10  0101  DIA  (AT  SEATING  PLANE)  AT  MAX 
MAT  L  CONDITION 

2  DIMENSION     L     TQ  CENTER  OF  LEADS 
WHEN  FORMED  PARALLEL 


Artrtrtrtrtrtrtrtrtrtrtrtrtn 

r,  rt  r,  f\  n 

) 

O 

fmmmMmm§"\f=\ 

-ImU  _e-  —  f      -Jt-o  *     _  « 


DIM 

MILLIMETERS 

INCHES 

MIN 

MAX 

MIN 

MAX 

A 

SI  69 

S2  4S 

2  0JS 

2  065 

• 

13  22 

14  22 

0S40 

0  560 

C 

3  94 

5  06 

0IS5 

0  200 

0 

0  36 

OSt 

0014 

0  022 

F 

102 

1  52 

ooto 

0  060 

G 

2  54  BSC 

0  10 

'BSC 

H 

1GS 

2  IC 

0  065 

0  065 

1 

020 

0  36 

0  001 

0  015 

K       292 

J  4] 

0115 

0  135 

I         1524  BSC 

0  E00  0SC 

M  ]    0" 

15° 

0° 

I5» 

N   !    051 

102 

0020 

0  040 

P  SUFFIX 

PLASTIC  PACKAGE 
CASE  711-03 


NOTES 

1  POSITIONAL  TOLEHANCE  OF  LEADS  101 
SHALL  BE  WITHIN  0  25  mm  10  0101  AT 
MAXIMUM  MATERIAL  CONDITION   IN 
RELATION  TO  SEATING  PLANE  AND 
EACH  OTHEH 

2  OIMENSION  l  TO  CENTER  OF  LEADS 
WHEN  FORMED  PARALLEL 

3  DIMENSION  0  ODES  NOT  INCIUOE 
MOLD  FLASH 


mftfiftftrtft/irtftftftftftfinfifl 
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S  SUFFIX 

CERDIP  PACKAGE 
CASE  734-03 


DIM 

MILLIMETERS 

INCHES 

MIN 

MAX 

MIN 

MAX 

A 

SI  31 

S3  24 

2  no 

2096 

a 

1210 

IS  49 

0  500 

0610 

c 

406 

514 

0160 

0  230 

D 

0  38 

OH 

OtIS 

0  022 

F 

127 

its 

0050 

OOSS 

* 

2  54  BSC 

ii  in 

BSC 

f 

D20   I    0  3O 

Dim 

0017 

« 

3  16  1    4  06 

0  125 

LOiHL. 

L 

IS  24  ISC 

tH 

BSC     1 

M 

S»      1    li» 

5» 

IS" 

N 

DS1    1    121 

0020  1  OOSO 

0H*EhSlON4  IS  DATUM 
PO-SlTHjNAL  TOLERANCE 
fOWJ-EADS 

I  >  Tm»iooipi©1  1  I* ©I 

pn  IS  SEAUNG  PLANE 
DIMENSION  L  TOCHtTEB 
OF  LEADS  WHEN  FOAMEO 
PAflALlEL 
DIMENSION  A  AND  B 
INCLUDES  MENISCUS 


Motorola  reserves  the  right  to  make  changes  to  any  products  herein  to  improve  reliability  f  unct  ion  or  design  Motorola  does  not  assume  any  liability  ansi  ng 
out  of  the  application  or  use  of  anv  product  or  circuit  described  herein  neither  does  it  convey  any  license  under  its  patent  rights  nor  the  rights  of  others 
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WESTER IV  DIGITAL 
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BR1941(5016)  Dual  Baud  Rate  Clock 


FEATURES 

16  SELECTABLE  BAUD  RATE  CLOCK  FREQUENCIES 

SELECTABLE  1 X,  16X  OR  32X  CLOCK  OUTPUTS  FOR 

FULL  DUPLEX  OPERATIONS 

OPERATES  WITH  CRYSTAL  OSCILLATOR  OR 

EXTERNALLY  GENERATED  FREQUENCY  INPUT 

ROM  MASKABLE  FOR  NON-STANDARD  FREQUENCY 

SELECTIONS 

INTERFACES  EASILY  WITH  MICROCOMPUTERS 

OUTPUTS  A  50%  DUTY  CYCLE  CLOCK  WITH  0.01  % 

ACCURACY 

6  DIFFERENT  FREQUENCY/DIVISOR  PAIRS 

AVAILABLE 

TTL,  MOS  COMPATIBILITY 

PtN  COMPATIBLE  WITH  COMS016 


GENERAL  DESCRIPTION 

The  BR1941  Is  a  combination  Baud  Rate  Clock  Gen- 
erator and  Programmable  Divider.  It  Is  manufactured  in 
N-channel  MOS  using  silicon  gate  technology.  This  de- 
vice is  capable  of  generating  16  externally  selected 
clock  rates  whose  frequency  is  determined  by  either  a 
single  crystal  or  an  externally  generated  input  clock 
The  BR1941  Is  a  programmable  counter  capable  of 
generating  a  division  from  2  to  (21S  - 1). 

The  BR1941  is  available  programmed  with  the  most 
used  frequencies  in  data  communication.  Each 
frequency  is  selectable  by  strobing  or  hard  wiring  each 
of  the  two  sets  of  four  Rate  Select  inputs.  Other 
frequencies/division  rates  can  be  generated  by 
reprogrammirvg  the  internal  ROM  coding  through  a 
MOS  mask  change.  Additionally,  further  clock  division 
may  be  accomplished  through  cascading  of  devices. 
The  frequency  output  is  fed  into  the  XTAUEXT  input 
on  a  subsequent  device. 


CD 


ja> 


XTAUEXT  1 

VCC 
<R 
f"A 
RB 
BC 
*D 
STR 
VDD 


c 
c 
c 
c 
c 
c 
c 
c 
c 


t  D  18 

2  17 

3  16 

4  15 

5  14 
BR1941 

6  13 

12 

11 
10 


3 
3 
3 
3 
3 
3 
3 
3 
3 


XTAUEXT  2 

<T 

TA 

tb 

TC 

TO 

STT 

GNO 

NC" 


•INTERNALLY  BONDED  DO  NOT  CONNECT 
ANYTHING  TO  THIS  PIN 


TA » 

TB  » 

TC  » 

TO  »> 

STT  

XTAU „ 

EXTl 

XTAU to 

EXT  2 

*\Tt ■" 

+  SV    »■ 

GNO    *■ 

*.<T 

»-lfl 

0 

( 
1. 

A 
T 
C 
H 

FREQUENCY 
DECODE 

AND 
CONTROL 

FREQUENCY 

SELECT 

ROM 

1 
t 
1 

"" 

1 



OSCILLATOR 

OIVIOER 

OIVIDER 

t~-: 

. 

RA   ■» 

RB  »" 

RC  »• 

RD  » 

T 

D 

1 
L 
A 
T 
C 
H 

FREQUENCY 
DECODE 

AND 
CONTROL 

FREQUENCY 

SELECT 

ROM 

PIN  CONNECTIONS 


BR1941  BLOCK  DIAGRAM 
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PIN  DESCRIPTION 


w 

30 

to 

tn 

o 
-a 


PIN  NUMBER 

SYMBOL 

NAME 

FUNCTION 

1 

XTAUEXT  1 

Crystal  or 
External  Input  1 

This  input  receives  one  pin  of  the  crystal  package  or 
one  polarity  of  the  external  input. 

2 

vcc 

Power  Supply 

+  5  volt.  Supply 

3 

fR 

Receiver  Output 
Frequency 

This   output    runs    at    a    frequency   selected    by   the 
Receiver  Address  inputs. 

4-7 

Ra.  Rb.  Rc  Rd 

Receiver  Address 

The  logic  level  on  these  inputs  as  shown  in  Tables  1 
through  6,  selects  the  receiver  output  frequency,  fp. 

8 

STR 

Strobe- Receiver 
Address 

A  high-level  input  strobe  loads  the  receiver  address 
(RA.  RB.  RC>  Rp)  'n,°  tne  receiver  address  register. 
This  input  may  be  strobed  or  hard  wired  to  +5V. 

9 

vdd 

Power  Supply 

+ 12  volt  Supply 

10 

NC 

No  Connection 

Internally  bonded.    Do  not  connect   anything   to  this 
pin. 

Ground 

11 

GND 

Ground 

12 

STT 

Strobe-Transmitter 
Address 

A  high-level  input  strobe  loads  the  transmitter  address 
fA-  Tg,  Tc,  Tq)  into  the  transmitter  address  register. 
This  input  may  be  strobed  or  hard  wired  to  +5V. 

13-16 

To,  Tc,  tb,  ta 

Transmitter 
Address 

The  logic  level  on  these  inputs,  as  shown  in  Tables  1 
through  6,  selects  the  transmitter  output  frequency,  f-r\ 

17 

<t 

Transmitter 

Output 

Frequency 

This   output    runs   at    a   frequency   selected    by   the 
Transmitter  Address  inputs. 

18 

XTAUEXT  2 

Crystal  or 
External 
Input  2 

This    input    receives    the    other    pin    of    the    crystal 
package  or  the  other  polarity  of  the  external  input. 

NOTE  1 

VIH 

STROBE 
(STR/STT) 

VIL  

TSETUP  - 


zz 


~\2  0V 
V  8V 


'HOLD 


ADDRESS 
VIL 


eZX 


2  0V 

8V 


XL 


-ADDRESS  NEED  ONLY  BE  VALID  DURING  THE  LAST 
TPW  TIME  OF  THE  INPUT  STROBE 


CRYSTAL  OPERATION  EXTERNAL  INPUT  OPERATION 

BRW1  M1M1 


506S8  MHz 


# 


)0fCRYSTAL  .      „£„ 


c|i     ief>-  ™**>  «-qi    iep      £xx>  • -[>  c]i     is|d- 


7<XX  —  TOTEM  POLE  OR  OPEN  COLLECTOR  OUTPUT 


o 


CONTROL  TIMING 


CRYSTAL/CLOCK  OPTIONS 


ABSOLUTE  MAXIMUM  RATINGS 

Positive  Voltage  on  any  Pin,  with  respect  to  ground 
Negative  Voltage  on  any  Pin,  with  respect  to  ground 
Storage  Temperature 


+  20.0V 

-0.3V 

(plastic  package)  -55°Cto  +125X 
(cerdip  package  and  ceramic  package)  -  65°C  to  +  150°C 

+  325°C 


Lead  Temperature  (Soldering,  10  sec.) 

"Stresses  above  those  listed  may  cause  permanent  damage  to  the  device.  This  is  a  stress 
rating  only  and  Functional  Operation  of  the  device  at  these  or  at  any  other  condition 
above  those  indicated  in  the  operational  sections  of  this  specification  are  not  implied. 


<w 
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ELECTRICAL  CHARACTERISTICS 

(Ta  =  0*C  to  +  70°C,  Vcc  =  +  5V  ±  5%,  Vdo  =  +  12V  ±  5%,  unless  otherwise  noted) 


PARAMETER 

MIN 

TYP 

MAX 

UNIT 

COMMENTS 

DC  CHARACTERISTICS 

INPUT  VOLTAGE  LEVELS 
Low-level,  V|l 
High-level,  Vih 

VcC-1-5 

0.8 

vcc 

V 

v 

See  Note  1 

OUTPUT  VOLTAGE  LEVELS 
Low-level,  Vol 
High-level,  Voh 

V<x -1-5 

4.0 

0.4 

V 
V 

lOL  =  3.2  mA 

l0H  =  1«VA 

INPUT  CURRENT 
Low-level,  l)L 

0.3 

mA 

Vin  =  GND,  excluding  XTAL  inputs 

INPUT  CAPACITANCE 
All  Inputs,  C|N 

5 

10 

pf 

V|n  =  GND,  excluding  XTAL  inputs 

INPUT  RESISTANCE 
Crystal  Input,  RxTAL 

1.1 

KQ 

Resistance  to  ground  for 
Pin  1  and  Pin  18 

POWER  SUPPLY  CURRENT 

ice 

IDD 

20 
20 

60 
70 

mA 
mA 

AC  CHARACTERISTICS 

TA=  +25"C 

CLOCK  FREQUENCY 

See  Note  2 

PULSE  WIDTH  (Tpw) 
Clock 

Receiver  strobe 
Transmitter  strobe 

150 
150 

DC 
DC 

ns 
ns 

50%  duty  cycle  + 10%.  See  Note  2 

INPUT  SET-UP  TIME  OSET-UP) 
Address 

50 

ns 

See  Note  3 

OUTPUT  HOLD  TIME  OHOLD) 
Address 

50 

ns 

09 

30 

mX 

2 
I 

<35 


NOTE1:  BR1941  —  XTAUEXT  inputs  are  either  TTL  compatible  or  crystal  compatible.  See  crystal  specification  in  Ap- 
plications Information  section. 
All  inputs  except  XTAL/EXT  have  internal  puH-up  resistors. 

NOTE  2:  Refer  to  frequency  option  tables  tor  maximum  input  frequency  on  XTAUEXT  pins. 
Typical  Clock  Pulse  width  is  1/2xCL 

NOTE  3:  Input  set-up  time  can  be  decreased  to  >0  ns  by  increasing  the  minimum  strobe  width  by  50  ns  to  a  total  of  200  ns. 


OPERATION 
Standard  Frequencies 

Choose  a  Transmitter  and  Receiver  frequency  from  the 
table  below.  Program  the  corresponding  address  into  TA- 
TD  and  RA-RD  respectively  using  strobe  pulses  or  by  hard 
wiring  the  strobe  and  address  inputs. 


Non-Standard  Frequencies 

To  accomplish  non-standard  frequencies  do  one  of  the 
following: 

1.  Choose  a  crystal  that  when  divided  by  the  BR1941 
generates  the  desired  frequency. 

2.  Cascade  devices  by  using  the  frequency  outputs  as  an 
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input  to 
BR1941. 


the  XTAUEXT   inputs  of   the   subsequent 


CD 

5        FREQUENCY  OPTIONS 
<P 


3.  Consult  the  factory  for  possible  changes  via  ROM  mask 
reprogramming. 


TABLE  1.  CRYSTAL  FREQUENCY 

=  5.0688  MHZ 

Transmit/Receive 

Baud 

Duty 

Address 

Rata         Theoretical 

Actual 

Percant 

Cycle 

0 

C 

B 

A 

(16X  Clock)    Freq.  (kHz) 

Freq.  (kHz) 

Error 

% 

Divisor 

0 

0 

0 

0 

50                   0.8 

08 

_ 

50/50 

6336 

0 

0 

0 

1 

75                   1.2 

1.2 

— 

50/50 

4224 

0 

0 

1 

0 

110                 1.76 

1.76 

— 

50/50 

2880 

0 

0 

1 

1 

134.5               2.152 

2.1523 

0.016 

50/50 

2355 

0 

1 

0 

0 

150                  2.4 

2.4 

— 

50/50 

2112 

0 

1 

0 

1 

300                   4.8 

4.8 

_ 

50/50 

1056 

0 

1 

1 

0 

600                   9.6 

9.6 

— 

50/50 

526 

0 

1 

1 

1 

1200                 19.2 

19.2 

— 

50/50 

264 

0 

0 

0 

1800                28.6 

28.8 

— 

50/50 

176 

0 

0 

1 

2000                32.0 

32.081 

0.253 

50/50 

158 

0 

1 

0 

2400                38.4 

38.4 

— 

50/50 

132 

0 

1 

1 

3600                57.6 

57.6 

— 

50/50 

86 

1 

0 

0 

4800                76.8 

76.8 

— 

50/50 

66 

1 

0 

1 

7200               115.2 

115.2 

— 

50/50 

44 

1 

1 

0 

9600               153.6 

153.6 

— 

48/52 

33 

1 

1 

1 

19,200              307.2 

316.8 

3.125 

50/50 

16 

BR1941-00 


BR1941-02 
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TABLE  2 

CLOCK  FREQUENCY   = 

2.76480  MHZ 

Transmit/Receive 

Baud 

Duty 

Addrass 

Rate          Theoretical 
(16X  Clock)     Fraq.  (kHz) 

Actual 
Fraq.  (kHz) 

Percent 
Error 

Cycle 

% 

Divisor 

D 

C 

B 

A 

0 

0 

0 

0 

50                   0.8 

0.8 

_ 

50/50 

3456 

0 

0 

0 

1 

75                    1.2 

1.2 

— 

50/50 

2304 

0 

0 

1 

0 

110                  1.76 

1.76 

-0.006 

50/50 

1571 

0 

0 

1 

1 

134.5                2.152 

2.152 

-0.019 

50/50 

1285 

0 

1 

0 

0 

150                   2.4 

2.4 

— 

50/50 

1152 

0 

1 

0 

1 

200                  3.2 

3.2 

— 

50/50 

664 

0 

1 

1 

0 

300                   4.8 

4.8 

_ 

50/50 

576 

0 

1 

1 

1 

600                   9.6 

9.6 

— 

50/50 

288 

0 

0 

0 

1200                19.2 

19.2 

— 

50/50 

144 

0 

0 

1 

1800                28.8 

28.8 

— 

50/50 

96 

0 

1 

0 

2000                32.0 

32.15 

+  0.465 

50/50 

86 

0 

1 

1 

2400                38.4 

38.4 

— 

50/50 

72 

1 

0 

0 

3600                57.6 

57.6 

— 

50/50 

48 

1 

0 

1 

4800                76.8 

76.8 

— 

50/50 

36 

1 

1 

0 

9600               153.6 

153.6 

— 

50/50 

18 

1 

1 

1 

19,200              307.2 

307.2 

— 

50/50 

9 

o 


TABLE  3.  CRYSTAL  FREQUENCY  = 

6.018305  MHZ 

Transmit/Receive 

Baud 

Duty 

Addrass 

Rate         Theoretical 
(16X  Clock)    Freq.  (kHz) 

Actual           Percent 
Fraq.  (kHz)         Error 

Cycle 

% 

Divisor 

D 

C 

B 

A 

0 

0 

0 

0 

50                    0.8 

.7999                  0 

50/50 

7523' 

0 

0 

0 

1 

75                     1.2 

1.2000                 0 

50/50 

5015' 

0 

0 

1 

0 

110                   1.76 

1.7597                 0 

50/50 

3420 

0 

0 

1 

1 

134.5                2.152 

2.1517                  0 

50/50 

2797- 

0 

1 

0 

0 

150                   2.4 

2.3996                 0 

50/50 

2508 

0 

1 

0 

1 

200                   3.2 

3.1995                  0 

50/50 

188T 

0 

1 

1 

0 

300                   4.8 

4.7993                  0 

50/50 

1254 

0 

1 

1 

1 

600                    9.6 

9.5986                  0 

50/50 

627- 

0 

0 

0 

1200                 19.2 

19.2279            +0.14 

50/50 

31.3* 

0 

0 

1 

1800                 28.8 

28.7959                 0 

50/50 

209- 

0 

1 

0 

2000                 32.0 

32.0125                0 

50/50 

188 

0 

1 

1 

2400                 38.4 

38.3334             -0.17 

50/50 

157* 

1 

0 

0 

3600                 57.6 

57.8687            +  0.46 

50/50 

104 

1 

0 

1 

4800                 76.8 

77.1583             +0.46 

50/50 

78 

1 

1 

0 

9800                153.6 

154.3166            +0.46 

50/50 

39- 

1 

1 

1 

19,200              307.2 

300.9175            -2.04 

50/50 

20 

w 
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TABLE  4. 

CLOCK  FREQUENCY  = 

5.52960  MHZ 

Transmit/Receive 

Baud 

Duty 

Address 

Rate         Theoretical 
(16X  Clock)    Freq.  (kHz) 

Actual 
Freq.  (kHz) 

Percent 
Error 

Cycle 

% 

Divisor 

D 

C 

B 

A 

0 

0 

0 

0 

50                   1.6 

1.6 



50/50 

3456 

0 

0 

0 

1 

76                   2.4 

2.4 

— 

50/50 

2304 

0 

0 

1 

0 

110                  3.52 

3.52 

-0.006 

50/50 

1571 

0 

0 

1 

1 

134.5              4.304 

4.303 

-  0.019 

50/50 

1285 

0 

1 

0 

0 

150                  4.8 

4.8 

— 

50/50 

1152 

0 

1 

0 

1 

200                   6.4 

6.4 

— 

50/50 

864 

0 

1 

1 

0 

300                   9.6 

9.6 

— 

50/50 

576 

0 

1 

1 

1 

600                  19.2 

19.2 

— 

50/50 

268 

0 

0 

0 

1200                38.4 

38.4 

_ 

50/50 

144 

0 

0 

1 

1800                57.6 

57.6 

— 

50/50 

96 

0 

1 

0 

2000                64.0 

64.3 

+  0.465 

50/50 

86 

0 

1 

1 

2400                76.6 

76.8 

— 

50/50 

72 

1 

0 

0 

3600               115.2 

115.2 

— 

50/50 

48 

1 

0 

1 

4800                153.6 

153.6 

— 

50/50 

36 

1 

1 

0 

9600                307.2 

307.2 

— 

50/50 

18 

1 

1 

1 

19,200              614.4 

614.4 

— 

50/50 

9 

m&r 
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TABLE  5. 

3RYSTAL  FREQUENCY 

=  4.9152  MHZ 

Transmit/Receive 

Baud 

Duty 

Address 

Rate          Theoretical 
(32X  Clock)     Freq.  (kHz) 

Actual 
Freq.  (kHz) 

Percent 
Error 

Cycle 

% 

Divisor 

D 

C 

B 

A 

0 

0 

0 

0 

50                   0.8 

0.8 



50/50 

6144 

0 

0 

0 

1 

75                   1.2 

1.2 

— 

50/50 

4096 

0 

0 

1 

0 

110                  1.76 

1.7598 

-0.01 

* 

2793 

0 

0 

1 

1 

134.5               2.152 

2.152 

— 

50/50 

2284 

0 

1 

0 

0 

150                  2.4 

2.4 

— 

50/50 

2048 

0 

1 

0 

1 

300                  4.8 

4.8 

— 

50/50 

1024 

0 

1 

1 

0 

600                  9.6 

9.6 

— 

50/50 

512 

0 

1 

1 

1 

1200                 19.2 

19.2 

— 

50/50 

256 

0 

0 

0 

1800                28.8 

28.7438 

-0.19 

* 

171 

0 

0 

1 

2000                32.0 

31.9168 

-0.26 

50/50 

154 

0 

1 

0 

2400                38.4 

38.4 

— 

50/50 

128 

0 

1 

1 

3600                57.6 

57.8258 

0.39 

• 

85 

1 

0 

0 

4800                76.8 

76.8 

— 

50/50 

64 

1 

0 

1 

7200               115.2 

114.306 

-0.77 

* 

43 

1 

1 

0 

9600               153.6 

153.6 

_ 

50/50 

32 

1 

1 

1 

19,200              307.2 

307.2 

— 

50/50 

16 

to 

CO 

1 
-0> 


BR1941-05 


TABLE  6.  CRYSTAL  FREQUENCY 

=  5.0688  MHZ 

Transmit/Receive 

Baud 

Duty 

Address 

Rate         Theoretical 
(32X  Clock)     Freq.  (kHz) 

Actual 
Freq.  (kHz) 

Percent 
Error 

Cycle 

% 

Divisor 

D 

C 

B 

A 

0 

0 

0 

0 

50                   1.6 

1.6 

— 

50/50 

3168 

0 

0 

0 

1 

75                   2.4 

2.4 

— 

50/50 

2112 

0 

0 

1 

0 

110                 3.52 

3.52 

— 

50/50 

1440 

0 

0 

1 

1 

134.5               4.304 

4.303 

.026 

50/50 

1178 

0 

1 

0 

0 

150                  4.8 

4.8 

— 

50/50 

1056 

0 

1 

0 

1 

200                  6.4 

6.4 

— 

50/50 

792 

0 

1 

1 

0 

300                  9.6 

9.6 

— 

50/50 

528 

0 

1 

1 

1 

600                 19.2 

19.2 

— 

50/50 

264 

0 

0 

0 

1200                 38.4 

38.4 

— 

50/50 

132 

0 

0 

1 

1800                 57.6 

57.6 

— 

50/50 

88 

0 

1 

0 

2400                 76.8 

76.8 

— 

50/50 

66 

0 

1 

1 

3600               115.2 

115.2 

— 

50/50 

44 

1 

0 

0 

4800               153.6 

153.6 

_ 

• 

33 

1 

0 

1 

7200               230.4 

230.4 

— 

50/50 

22 

1 

1 

0 

9600               307.2 

298.16 

2.941 

* 

17 

1 

1 

1 

19,200             614.4 

633.6 

3.125 

50/50 

8 

'When  the  duty  cycle  is  not  exactly  50%  it  is  50% 


10% 
BR1941-06 
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CRYSTAL  SPECIFICATIONS 

User  must  specify  termination  (pin,  wire,  other) 
Frequency  —  See  Tables  1-6. 
Temperature  range  O'C  to  +  70°  C 
Series  resistance  <  50Q 
Series  resonant 
Overall  tolerance  ±  .01  % 

CRYSTAL  MANUFACTURERS  (Partial  List) 

American  Time  Products  Div. 
Frequency  Control  Products,  Inc. 
61-20  Woodside  Ave. 
Woodside,  New  York  11377 
(212)458-5811 


Bliley  Electric  Co. 
2545  Grandview  Blvd. 
Erie,  Pennsylvania  16508 
(814)838-3571 

M-tron  Ind.  Inc. 

P.O.  Box  630 

Yankton,  South  Dakota  57078 

(605)665-9321 

Erie  Frequency  Control 

453  Lincoln  St. 

Calisle,  Pennsylvania  17013 

(714)249-2232 


APPLICATIONS  INFORMATION 


OPERATION  WITH  A  CRYSTAL 

The  BR1941  Baud  Rate  Generator  may  be  driven  by  either  a 
crystal  or  TTL  level  clock.  When  using  a  crystal,  the  wave- 
form that  appears  at  pins  1  (XTAUEXT 1)  and  18  (XTAUEXT 
2)  does  not  conform  to  the  normal  TTL  limits  of  Vil  <  0.8V 
and  V|h  >  2.0V.  Figure  1  illustrates  a  typical  crystal 
waveform  when  connected  to  a  BR1941. 

Since  the  D.C.  level  of  the  waveform  causes  the  least 
positive  point  to  typically  be  greater  than  0.8V,  the  BR1941 
is  designed  to  look  for  an  edge,  as  opposed  to  a  TTL  level. 
The  XTAUEXT  logic  triggers  on  a  rising  edge  of  typically  1 V 
in  magnitude.  This  allows  the  use  of  a  crystal  without  any 
additional  components. 

OPERATIONS  WITH  TTL  LEVEL  CLOCK 

With  clock  frequencies  in  the  area  of  5  MHz,  significant 
overshoot  and  undershoot  ("ringing")  can  appear  at  pins  1 
and/or  18.  The  BR1941,  may,  at  times,  be  triggered  on  a 
rising  edge  of  an  overshoot  or  undershoot  waveform, 
causing  the  device  to  effectively  "double-trigger."  This 
phenomenon  may  result  as  a  twice  expected  baud  rate,  or 
as  an  apparent  device  failure.  Figure  2  shows  a  typical 
waveform  that  exhibits  the  "ringing"  problem. 

The  design  methods  required  to  minimize  ringing  include 
the  following: 

1.  Minimize  the  P.C.  trace  length.  At  5  MHz,  each  inch  of 
trace  can  add  significantly  to  overshoot  and  undershoot. 

2.  Match  impedances  at  both  ends  of  the  trace.  For 
example,  a  series  resistor  near  the  BR  1941  may  be 
helpful. 

3.  A  uniform  impedance  is  important.  This  can  be  ac- 
complished through  the  use  of: 


a  parallel  ground  lines 

b.  evenly  spaced  ground  lines  crossing  the  trace  on  the 
opposite  side  of  PC  board 

c.  an  inner  plane  of  ground,  e.g.,  as  in  a  four  layered  PC 
board. 

In  the  event  that  ringing  exists  on  an  already  finished 
board,  several  techniques  can  be  used  to  reduce  it.  These 
are: 

1.  Add  a  series  resistor  to  match  impedance  as  shown  in 
Figure  3. 

2.  Add  pull-up/pull-down  resistor  to  match  impedance,  as 
shown  in  Figure 4. 

3.  Add  a  high  speed  diode  to  clamp  undershoot,  as  shown 
in  Figure  5. 

The  method  that  is  easiest  to  implement  in  many  systems 
is  method  1,  the  series  resistor.  The  series  resistor  will 
cause  the  D.C.  level  to  shift  up,  but  that  does  not  cause  a 
problem  since  the  BR1941  is  triggered  by  an  edge,  as 
opposed  to  a  TTL  level. 

The  BR1941  Baud  Rate  Generator  can  save  both  board 
space  and  cost  in  a  communications  system.  By  choosing 
either  a  crystal  or  a  TTL  level  clock,  the  user  can  minimize 
the  logic  required  to  provide  baud  rate  clocks  in  a  given 
design. 

POWER  LINE  SPIKES 

Voltage  transients  on  the  AC  power  line  may  appear  on  the 
DC  power  output.  If  this  possibility  exists,  it  is  suggested 
that  one  by-pass  capacitor  is  used  between  +  5V  and  GND 
and  another  between  +  12V  and  GND. 
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Figure  1  TYPICAL  CRYSTAL  WAVEFORM 


Figure  2  TYPICAL  "RINGING"  WAVEFORM 
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BR1941 


Typical  Values 
R1  =  R2  '  33S1 


Figure  3  SERIES  RESISTOR  TO  MATCH  IMPEDANCE 
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Typical  Values 
R1  =  R3  =  ?  7K 
R2  =  R4  =  3  3K 


Figure  4  PULL-UP/PULL-DOWN  RESISTORS  TO  MATCH  IMPEDANCE 
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BR1941 


Figure  5  HIGH-SPEED  DIODE  TO  CLAMP  UNDERSHOOT 


See  page  725  for  ordering  information. 


385 


# 


o 


Information  furnished  by  Western  Digital  Corporation  is  believed  to  be  accurate  and  reliable  However  no  responsibility  is  assumed  by  Western  Digital 
Corporation  for  its  use  nor  lor  any  infringements  ol  patents  or  other  rights  of  third  parties  which  may  result  from  its  use  No  license  is  granted  by 
implication  or  otherwise  under  any  patent  or  patent  rights  of  Western  Digital  Corporation  Western  Digital  Corporation  reserves  the  right  to  change 
specifications  at  anytime  without  notice 
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Pi<m«d  >n  u  S  A 


<W 


WESTERN  DIGITAL 

CORPORATION 

WD1943(8116VWD1945(8136)  Dual  Baud  Rate  Clock 


i 


FEATURES 

•  16  SELECTABLE  BAUD  RATE  CLOCK  FREQUENCIES 

•  OPERATES  WITH  CRYSTAL  OSCILLATOR  OR  EX- 
TERNALLY GENERATED  FREQUENCY  INPUT 

•  ROM  MASKABLE  FOR  NON-STANDARD  FREQUENCY 
SELECTIONS 

•  INTERFACES  EASILY  WITH  MICROCOMPUTERS 

•  OUTPUTS  A  50%  DUTY  CYCLE  CLOCK  WITH  001% 
ACCURACY 

•  6  DIFFERENT  FREQUENCY/DIVISOR  PAIRS 
AVAILABLE 

•SINGLE  +  5V  POWER  SUPPLY 

•  COMPATIBLE  WITH  BR1941 

•  TTL,  MOS  COMPATIBILITY 

•  WD1943  IS  PIN  COMPATIBLE  TO  THE  COM81 16 

•  WD1945  IS  PIN  COMPATIBLE  TO  THE  COM8136  AND 
COM5036  (PIN  9  ON  WD1945  IS  A  NO  CONNECT) 


GENERAL  DESCRIPTION 

The  WD1943/45  is  an  enhanced  version  of  the  BR1941  Dual 
Baud  Rate  Clock  The  WD1 943/45  is  a  combination  Baud 
Rate  Clock  Generator  and  Programmable  Divider  It  is 
manufactured  in  N-channel  MOS  using  silicon  gate 
technology  This  device  is  capable  of  generating  16  ex- 
ternally selected  clock  rates  whose  frequency  is  deter- 
mined by  either  a  single  crystal  or  an  externally  generated 
input  clock  The  WD1943/45  is  a  programmable  counter 
capable  of  generating  a  division  by  any  integer  from  4  to 
215 —  1,  inclusive 

The  WD1943/45  is  available  programmed  with  the  most 
used  frequencies  in  data  communication  Each  frequency 
is  selectable  by  strobing  or  hard  wiring  each  of  the  two  sets 
of  four  Rate  Select  inputs  Other  frequencies/division  rates 
can  be  generated  by  reprog  ramming  the  internal  ROM 
coding  through  a  MOS  mask  change  Additionally,  further 
clock  division  may  be  accomplished  through  cascading  of 
devices  The  frequency  output  is  fed  into  the  XTAUEXT 
input  on  a  subsequent  device 

The  WD1 943/45  can  be  driven  by  an  external  crystal  or  by 
TTL  logic 
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PIN  DESCRIPTION 


PIN  NUMBER 

SYMBOL 

NAME 

FUNCTION 

1 

XTAL/EXT  1 

Crystal  or 
External  Input  1 

This  input  receives  one  pin  of  the  crystal  package  or  one 
polarity  of  the  external  input. 

2 

vcc 

Power  Supply 

+  5  volt  Supply 

3 

fR 

Receiver  Output 
Frequency 

This  output  runs  at  a  frequency  selected  by  the  Receiver 
Address  inputs. 

4-7 

Ra.  Rb.  Rc.  Rd 

Receiver  Address 

The  logic  level  on  these  inputs  as  shown  in  Table  1  thru  6, 
selects  the  receiver  output  frequency,  f  r. 

8 

STR 

Strobe-Receiver 
Address 

A  high-level  input  strobe  loads  the  receiver  address  (Ra.  Rb. 
RC.  RD)  '"to  the  receiver  address  register.  This  input  may  be 
strobed  or  hard  wired  to  +5V. 

9 

NC 

No  Connection 

No  Internal  Connection 

10 

NC(1943) 

f/4(1945) 

No  Connection 
freq/4  Output 

No  Internal  Connection 

XTAL1  input  freq  divided  by  four 

11 

GND 

Ground 

Ground 

12 

STT 

Strobe-Transmitter 
Address 

A  high-level  input  strobe  loads  the  transmitter  address  (Ja, 
Tb>  tc,  Tq)  into  the  transmitter  address  register.  This  input 
may  be  strobed  or  hard  wired  to  +  5V. 

13-16 

To,Tc.Tb,Ta 

Transmitter 
Address 

The  logic  level  on  these  inputs,  as  shown  in  Table  1  thru  6, 
selects  the  transmitter  output  frequency,  f-r. 

17 

fT 

Transmitter 

Output 

Frequency 

This  output  runs  at  a  frequency  selected  by  the  Transmitter 
Address  inputs. 

18 

XTAL/EXT  2 

Crystal  or 
External 
Input  2 

This  input  receives  the  other  pin  of  the  crystal  package  or  the 
other  polarity  of  the  external  input. 

• 


STROSE 
|STR/STT( 

VIL i- 


'SET  UP  i 

SEC  NOTE  > 
MOE3 


rii 


"" — \.r 

m.  f    \- 


-  THOL0 


x: 


'  ADDRESS  NEED  ONLY  Bt  Vm.  IQ  during  THE  LAST 
TPW  TIME  OF  THE  INPUT  STROBE 


CRYSTAL  OPERATION 
WD1M3S4S 


EXTERNAL  INPUT  OPERATION 
WD  1943/45 


_    CRYSTAL  iv 

r^~\     r^-\    j— — ] 


HXX   TOT€MPOlEOROPSNCOU.ECTOfiOUTf>UT 


o 


CONTROL  TIMING 


CRYSTAL/CLOCK  OPTIONS 


ABSOLUTE  MAXIMUM  RATINGS 

Positive  Voltage  on  any  Pin,  with  respect  to  ground 
Negative  Voltage  on  any  Pin,  with  respect  to  ground 
Storage  Temperatu  re 

Lead  Temperature  (Soldering,  10  sec.) 


+  7.0V 

-0.3V 

(plastic  package)  -  55°C  to  +  125*C 
(Cerdip  package  and  Ceramic  package)  -65*C  to  +  150*C 


+  325°C 


'Stresses  above  those  listed  may  cause  permanent  damage  to  the  device.  This  is  a  stress 
rating  only  and  Functional  Operation  of  the  device  at  these  or  at  any  other  condition 
above  those  indicated  in  the  operational  sections  of  this  specification  are  not  implied. 
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ELECTRICAL  CHARACTERISTICS   (TA 

=  0*'Cto  + 

70°  C,  Vqc  =  +  5V  ±  5%  standard.) 

PARAMETER 

MIN 

TYP 

MAX 

UNIT 

COMMENTS 

DC  CHARACTERISTICS 

INPUT  VOLTAGE  LEVELS 
Low-level,  V|(_ 
High-level,  V|h 

2.0 

0.8 

vec 

V 
V 

See  Note  1 

OUTPUT  VOLTAGE  LEVELS 
Low-level,  Vol 
High-level,  Voh 

Vcc-15 

4.0 

0.4 

V 
V 

'OL  =  3.2  mA 
lOH  =  1«VA 

INPUT CURRENT 
High-level,  Iih 
Low-level,  l||_ 

Low-level,  l|L 

-10 
10 
300 

10 

MA 
mA 
JiA 

V|N  =  Vcc    STR  (8)  and  STT  (12) 

V|N  =  GND    Only 

V|N  =  GND    (All  inputs  except 

XTAL,  STR  and  STT) 
Vin  =  GND  STR,  STT 

INPUT  CAPACITANCE 
All  Inputs,  C(N 

5 

10 

P« 

V|N  =  GND,  excluding  XTAL  inputs 

EXT.  INPUT  LOAD 

4 

5 

Series  7400  unit  loads 

INPUT  RESISTANCE 
Crystal  Input,  RxTAL 

POWER  SUPPLY  CURRENT 

ice 

1.1 

40 

80 

KQ 
mA 

Resistance  to  ground  for 
Pin1  and  Pin  18 

AC  CHARACTERISTICS 

Ta  =  +  25°C 

CLOCK  FREQUENCY 

See  Note  2 

PULSE  WIDTH  <TpW) 
Clock 

Receiver  strobe 
Transmitter  strobe 

150 
150 

DC 
DC 

ns 
ns 

50%  Duty  Cycle  ±  10%.  See  Note  2 
See  Note  3 
See  Note  3 

INPUT  SET-UP  TIME  OSET-UP) 
Address 

50 

ns 

See  Note  3 

OUTPUT  HOLD  TIME  (THOLD) 
Address 

50 

ns 

STROBE  TO  NEW  FREQUENCY 
DELAY 

6 

CLK 

2 
f 


NOTE  1 :  XTAUEXT  inputs  are  either  TTL  compatible  or  crystal  compatible.  See  crystal  specification  in 

Applications  Information  section. 

All  inputs  except  XTAL,  STR  and  STT  have  internal  pull-up  resistors. 
NOTE  2:  Refer  to  frequency  option  tables  for  maximum  input  frequency  on  XTAUEXT  pins. 

Typical  clock  pulse  width  is  1/2  x  CL 
NOTE  3:  Input  set-up  time  can  be  decreased  to  >0  ns  by  increasing  the  minimum  strobe  width  (50  ns)  to  a  total  of  200  ns. 

Ta-D  ar>d  Ra-D  nave  Infernal  pull-up  resistors. 


OPERATION 

Standard  Frequencies 

Choose  a  Transmitter  and  Receiver  frequency  from  the 
table  below.  Program  the  corresponding  address  into  TA-TD 
and  RA-RD  respectively  using  strobe  pulses  or  by  hard 
wiring  the  strobe  and  address  inputs. 


Non-Standaid  Frequencies 

To  accomplish  non-standard  frequencies  do  one  of  the 
following: 

1.  Choose  a  crystal  that  when  divided  by  the  WD1943 
generates  the  desired  frequency. 

2.  Cascade  devices  by  using  the  frequency  outputs  as  an 
input  to  the  XTAUEXT  inputs  of  the  subsequent 
WD1943/45. 

3.  Consult  the  factory  for  possible  changes  via  ROM  mask 
reprog  ramming. 
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FREQUENCY  OPTIONS 


TABLE  1.  ( 

CRYSTAL  FREQUENCY 

=  5.0688  MHZ 

Transmit/Receive 

Baud 

Duly 

Address 

Rat*        Theoretical 

Actual 

Percent 

Cycle 

D 

C 

B 

A 

(16X  Clock)    Freq.  (kHz) 

Freq.  (kHz) 

Error 

% 

Divisor 

0 

0 

0 

0 

50                  0.8 

0.8 

— 

50/50 

6336 

0 

0 

0 

1 

75                   1.2 

1.2 

— 

50/50 

4224 

0 

0 

1 

0 

110                 1.76 

1.76 

— 

50/50 

2880 

0 

0 

1 

1 

134.5              2.152 

2.1523 

0.016 

50/50 

2355 

0 

1 

0 

0 

150                 2,4 

2.4 

— 

50/50 

2112 

0 

1 

0 

1 

300                 44 

4.8 

— 

50/50 

1056 

0 

1 

1 

0 

600                 9.6 

9.6 



50/50 

528 

0 

1 

1 

1 

1200                19.2 

19.2 

— 

50/50 

264 

0 

0 

0 

1800               28.8 

28.8 

— 

50/50 

176 

0 

0 

1 

2000                32.0 

32.081 

0.253 

50/50 

158 

0 

1 

0 

2400               38.4 

38.4 

— 

50/50 

132 

0 

1 

1 

3600                57.6 

57.6 

— 

50/50 

68 

1 

0 

0 

4800                76.8 

76.8 

— 

50/50 

66 

1 

0 

1 

7200                115.2 

115.2 

— 

50/50 

44 

1 

1 

0 

9600               153.6 

153.6 

— 

48/52 

33 

1 

1 

1 

19,200             307.2 

316.8 

3.125 

50/50 

16 

9 


WD1943-00  or  WD1945O0 


TABLE  2. 

CLOCK  FREQUENCY  = 

2.76480  MHZ 

Transmit/Receive 

Baud 

Duty 

Address 

Rat*         Theoretical 

Actual 

Percent 

Cycle 

D 

C 

B 

A 

(16X  Clock)    Ft«q.  (kHz) 

Fraq.  (kHz) 

Error 

% 

Divisor 

0 

0 

0 

0 

50                 0.8 

0.8 

— 

50/50 

3456 

0 

0 

0 

1 

75                   1.2 

1.2 

— 

50/50 

2304 

0 

0 

1 

0 

110                 1.76 

1.76 

-0.006 

50/50 

1571 

0 

0 

1 

1 

134.5              2.152 

2.152 

-  0.019 

50/50 

1285 

0 

1 

0 

0 

150                 2.4 

2.4 



50/50 

1152 

0 

1 

0 

1 

200                 3.2 

3.2 

__ 

50/50 

864 

0 

1 

1 

0 

300                 4.8 

4.8 

— 

50/50 

576 

0 

1 

1 

1 

600                 9.6 

9.6 

— 

50/50 

288 

0 

0 

0 

1200                19.2 

19.2 

_ 

50/50 

144 

0 

0 

1 

1800                28.8 

28.8 

— 

50/50 

96 

0 

1 

0 

2000                32.0 

32.15 

+  0.465 

50/50 

86 

0 

1 

1 

2400                38.4 

38.4 

— 

50/50 

72 

1 

0 

0 

3600                57.6 

57.6 

— 

50/50 

48 

1 

0 

1 

4800                76.8 

76.8 

— 

50/50 

36 

1 

1 

0 

9600               153.6 

153.6 

— 

50/50 

18 

1 

1 

1 

19,200             307.2 

307.2 

— 

50/50 

9 

WD1943-02  or  WD1 94502 


TABLE  3.  CRYSTAL  FREQUENCY  =  6.018305  MHZ 


WD1943-03  or  WD1945-03 


400 


o 


Transmit/Receive 

Baud 

Duty 

Address 

Rata 
(16X  Clock) 

Theoretical 
Freq.  (kHz) 

Actual 
Fraq.  (kHz) 

Percent 
Error 

Cycle 

% 

Divisor 

0 

C 

B 

A 

0 

0 

0 

0 

50 

0.8 

.7999 

0 

50/50 

7523* 

0 

0 

0 

1 

75 

1.2 

1.2000 

0 

50/50 

5015* 

0 

0 

1 

0 

110 

1.76 

1.7597 

0 

50/50 

3420 

0 

0 

1 

1 

134.5 

2.152 

2.1517 

0 

50/50 

2797* 

0 

1 

0 

0 

150 

2.4 

2.3996 

0 

50/50 

2508 

0 

1 

0 

1 

200 

3.2 

3.1995 

0 

50/50 

1881* 

0 

1 

1 

0 

300 

4.8 

4.7993 

0 

50/50 

1254 

0 

1 

1 

1 

600 

9.6 

9.5986 

0 

50/50 

627* 

0 

0 

0 

1200 

19.2 

19.2279 

+  0.14 

50/50 

31.3* 

0 

0 

1 

1800 

28.8 

28.7959 

0 

50/50 

209* 

0 

1 

0 

2000 

32.0 

32.0125 

0 

50/50 

188 

0 

1 

1 

2400 

38.4 

38.3334 

-0.17 

50/50 

157* 

1 

0 

0 

3600 

57.6 

57.8687 

+  0.46 

50/50 

104 

1 

0 

1 

4800 

76.8 

77.1583 

+  0.46 

50/50 

78 

1 

1 

0 

9800 

153.6 

154.3166 

+  0.46 

50/50 

39* 

1 

1 

1 

19,200 

307.2 

300.9175 

-2.04 

50/50 

20 

w 


TABLE  4. 

CLOCK  FREQUENCY  = 

5.52960  MHZ 

Transmit/Receive 

Baud 

Duty 

Addraaa 

Rate        Theoretical 

Actual 

Parcanl 

Cycla 

D 

C 

B 

A 

<32X  Clock)    Freq.  (kHz) 

Freq.  (kHz) 

Error 

% 

Divisor 

0 

0 

0 

0 

50                   1.6 

1.6 

_ 

50/50 

3456 

0 

0 

0 

1 

75                  2.4 

2.4 

— 

50/50 

2304 

0 

0 

1 

0 

110                 3.52 

3.52 

-0.006 

50/50 

1571 

0 

0 

1 

1 

134.5              4.304 

4.303 

-  0.019 

50/50 

1285 

0 

1 

0 

0 

150                 4.6 

4.8 



50/50 

1152 

0 

1 

0 

1 

200                 6.4 

6.4 

— 

50/50 

864 

0 

1 

1 

0 

300                 9.6 

9.6 



50/50 

576 

0 

1 

1 

1 

600                 19.2 

19.2 

— 

50/50 

288 

0 

0 

0 

1200               38.4 

38.4 

— 

50/50 

144 

0 

0 

1 

1800                57.6 

57.6 

_ 

50/50 

96 

0 

1 

0 

2000                64.0 

64.3 

+  0.465 

50/50 

86 

0 

1 

1 

2400                76.8 

76.8 

— 

50/50 

72 

1 

0 

0 

3600               115.2 

115.2 



50/50 

48 

1 

0 

1 

4800               153.6 

153.6 

— 

50/50 

36 

1 

1 

0 

9600               307.2 

307.2 

— 

50/50 

18 

1 

1 

1 

19,200             614.4 

614.4 

— 

50/50 

9 

WD194304  or  WD194504 
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TABLE  5.  CRYSTAL  FREQUENCY 

=  4.9152  MHZ 

Transmit/Receive 

Baud 

Duty 

Addraaa 

Rata         Thaoratlcal 
(16X  Clock)    Fraq.  (kHz) 

Actual 
Freq.  (kHz) 

Parcant 
Error 

Cycla 

% 

Dhieor 

D 

C 

B 

A 

0 

0 

0 

0 

SO                 0.8 

0.8 



50/50 

6144 

0 

0 

0 

1 

75                   1.2 

1.2 

— 

50/50 

4096 

0 

0 

1 

0 

110                 1.76 

1.7598 

-0.01 

* 

2793 

0 

0 

1 

1 

134.5              2.152 

2.152 

— 

50/50 

2284 

0 

1 

0 

0 

150                  2.4 

2.4 

— 

50/50 

2048 

0 

1 

0 

1 

300                  4.8 

4.8 

— 

50/50 

1024 

0 

1 

1 

0 

600                  9.6 

9.6 

— 

50/50 

512 

0 

1 

1 

1 

1200                19.2 

19.2 

— 

50/50 

256 

0 

0 

0 

1800                28.8 

28.7438 

-0.19 

* 

171 

0 

0 

1 

2000                32.0 

31.9168 

-0.26 

50/50 

154 

0 

1 

0 

2400                38.4 

38.4 

— 

50/50 

128 

0 

1 

1 

3600                57.6 

57.8258 

0.39 

• 

85 

1 

0 

0 

4800                76.8 

76.8 

— 

50/50 

64 

1 

0 

1 

7200               115.2 

114.306 

-0.77 

* 

43 

1 

1 

0 

9600               153.6 

153.6 

— 

50/50 

32 

1 

1 

1 

19,200             307.2 

307.2 

— 

50/50 

16 

WD1943-05  or  WD1945-05 


TABLE  6.  CRYSTAL  FREQUENCY 

=  5.0688  MHZ 

Tranemit/Recelve 

Baud 

Duty 

Addraaa 

Rata         Thaoratlcal 

Actual 

Parcant 

Cycla 

% 

0 

C 

B 

A 

(32X  Clock)    Freq.  (kHz) 

Fraq.  (kHz) 

Error 

Divisor 

0 

0 

0 

0 

50                   1.6 

1.6 

_ 

50/50 

3168 

0 

0 

0 

1 

75                  2.4 

2.4 



50/50 

2112 

0 

0 

1 

0 

110                3.52 

3.52 

— 

50/50 

1440 

0 

0 

1 

1 

134.5              4.304 

4.303 

.026 

50/50 

1178 

0 

1 

0 

0 

150                  4.8 

4.8 

— 

50/50 

1056 

0 

1 

0 

1 

200                  6.4 

6.4 

— 

50/50 

792 

0 

1 

1 

0 

300                 9.6 

9.6 



50/50 

528 

0 

1 

1 

1 

600                 19.2 

19.2 



50/50 

264 

0 

0 

0 

1200                38.4 

38.4 

— 

50/50 

132 

0 

0 

1 

1800                 57.6 

57.6 

-_ 

50/50 

88 

0 

1 

0 

2400                 76.8 

76.8 



50/50 

66 

0 

1 

1 

3600               115.2 

115.2 



50/50 

44 

1 

0 

0 

4800               153.6 

153.6 

— 

• 

33 

1 

0 

1 

7200               230.4 

230.4 



50/50 

22 

1 

1 

0 

9600               307.2 

298.16 

2.941 

• 

17 

1 

1 

1 

19,200             614.4 

633.6 

3.125 

50/50 

8 

'When  the  duty  cycle  is  not  exactly  50%  it  is  50%  ±  10% 


WD1 94306  or  WD194506 
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APPLICATIONS  INFORMATION 


OPERATION  WITH  A  CRYSTAL 

The  WD1943/45  Baud  Rate  Generator  may  be  driven  by 
either  a  crystal  or  TTL  level  clock.  When  using  a  crystal,  the 
waveform  that  appears  at  pins  1  (XTAUEXT  1)  and  18 
(XTAUEXT  2)  does  not  conform  to  the  normal  TTL  limits  of 
V||_  <  0.8V  and  V|h  >  2.0V.  Figure  1  illustrates  a  typical 
crystal  waveform  when  connected  to  a  WD1 943/45. 

Since  the  D.C.  level  ol  the  waveform  causes  the  least 
positive  point  to  typically  be  greater  than  0.8V,  the 
WD1 943/45  is  designed  to  look  for  an  edge,  as  opposed  to  a 
TTL  level.  The  XTAUEXT  logic  triggers  on  a  rising  edge  of 
typically  1V  in  magnitude.  This  allows  the  use  of  a  crystal 
without  any  additional  components. 

OPERATIONS  WITH  TTL  LEVEL  CLOCK 

With  clock  frequencies  in  the  area  of  5  MHz,  significant 
overshoot  and  undershoot  ("ringing")  can  appear  at  pins  1 
and/or  18.  The  clock  oscilator  may,  at  times  be  triggered  on 
a  rising  edge  of  an  overshoot  or  undershoot  waveform, 
causing  the  device  to  effectively  "double-trigger."  This 
phenomenon  may  result  as  a  twice  expected  baud  rate,  or 
as  an  apparent  device  failure.  Figure  2  shows  a  typical 
waveform  that  exhibits  the  "ringing"  problem. 

The  design  methods  required  to  minimize  ringing  include 
the  following: 

1.  Minimize  the  P.C.  trace  length.  At  5  MHz,  each  inch  of 
trace  can  add  significantly  to  overshoot  and  undershoot. 

2.  Match  impedances  at  both  ends  of  the  trace.  For 
example,  a  series  resistor  near  the  device  may  be 
helpful. 

3.  A  uniform  impedance  is  important  This  can  be  ac- 
complished through  the  use  of: 

a  parallel  ground  lines 

b.  evenly  spaced  ground  lines  crossing  the  trace  on  the 
opposite  side  of  PC  board 

c.  an  inner  plane  of  ground,  e.g.,  as  in  a  four  layered  PC 
board. 

In  the  event  that  ringing  exists  on  an  already  finished 
board,  several  techniques  can  be  used  to  reduce  it.  These 
are: 

1.  Add  a  series  resistor  to  match  impedance  as  shown  in 
Figure  3. 

2.  Add  pull-up/pull-down  resistor  to  match  impedance,  as 
shown  in  Figure  4. 

3.  Add  a  high  speed  diode  to  clamp  undershoot,  as  shown 
in  Figure  5. 


The  method  that  is  easiest  to  implement  in  many  systems 
is  method  1,  the  series  resistor.  The  series  resistor  will 
cause  the  D.C.  level  to  shift  up,  but  that  does  not  cause  a 
problem  since  the  OSC  is  triggered  by  an  edge,  as  opposed 
to  a  TTL  levei. 


The  1943/45  Baud  Rate  Generator  can  save  both  board 
space  and  cost  in  a  communications  system.  By  choosing 
either  a  crystal  or  a  TTL  level  clock,  the  user  can  minimize 
the  logic  required  to  provide  baud  rate  clocks  in  a  given 
design. 


POWER  LINE  SPIKES 

Voltage  transients  on  the  AC  power  line  may  appear  on  the 
DC  power  output.  If  this  possibility  exists,  it  is  suggested 
that  a  by-pass  capacitor  is  used  between  +  5V  and  GND. 


CRYSTAL  SPECIFICATIONS 

User  must  specify  termination  (pin,  wire,  other) 

Frequency  —  See  Tables  1-6. 

Temperature  range  0*C  to  +  70°C 

Series  resistance  <  50Q 

Series  resonant 

Overall  tolerance  ±  0.01% 


CRYSTAL  MANUFACTURERS  (Partial  List) 

American  Time  Products  Div. 
Frequency  Control  Products,  Inc. 
61-20  Woodside  Ave. 
Woodside,  New  York  11377 
(213)458-5811 

Bliley  Electric  Co. 
2545  Grandview  Blvd. 
Erie,  Pennsylvania  16508 
(814)838-3571 

M-tron  Ind.  Inc. 

P.O.  Box  630 

Yankton,  South  Dakota  57078 

(605)665-9321 

Erie  Frequency  Control 

453  Lincoln  St. 

Calisle,  Pennsylvania  17013 

(714)249-2232 
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Figure  1.  TYPICAL  CRYSTAL  WAVEFORM 


Figure  2.  TYPICAL  "RINGING"  WAVEFORM 
from  TTL  INPUT 
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TypicaWaluM 
Rl  =  R2  =  330 


Figure  3.  SERIES  RESISTOR  TO  MATCH  IMPEDANCE 


■O- 


Typical  vtluit 
R1  =  H3  =  2  7K 
RJ  =  R4  =  3  3K 


Figure  4.  PULL-UP/PULLDOWN  RESISTORS  TO  MATCH  IMPEDANCE 


■£*■ 


Figure  5.  HIGH-SPEED  DIODE  TO  CLAMP  UNDERSHOOT 


See  page  725  for  ordering  information. 
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Information  furnished  by  Western  Digital  Corporation  is  believed  to  be  accurate  and  reliable  However,  no  responsibility  is  assumed  by  Western  Digital 
Corporation  lor  us  use,  nor  lor  any  infringements  of  patents  or  other  rights  ot  third  parties  which  may  result  from  its  use  No  license  is  granted  by 
implication  or  otherwise  under  any  patent  or  patent  rights  ol  Western  Digital  Corporation  Western  Digital  Corporation  reserves  the  right  to  change 
specifications  at  anytime  without  notice 
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Pfinlca  .n  U  S  A 


WESTERN  DIGITAL 

CORPORAT/ON 

FD179X-02 
Floppy  Disk  Formatter/Controller  Family 


FEATURES 

•  TWO  VFO  OONTROL  SIGNALS  —  RG  &  VFOE 

•  SOFT  SECTOR  FORMAT  COMPATIBILITY 

•  AUTOMATIC  TRACK  SEEK  WITH  VERIFICATION 

•  ACCOMMODATES  SINGLE  AND  DOUBLE  DENSITY 
FORMATS 

IBM  3740  Single  Density  <FM) 

IBM  System  34  Double  Density  (MFM) 

Non  IBM  Format  for  Increased  Capacity 

•  READ  MODE 

Single/Multiple  Sector  Read  with  Automatic  Search  or 

Entire  Track  Read 
Selectable  128, 256, 512  or  1024  Byte  Sector  Lengths 

•  WRITE  MODE 

Single/Multiple  Sector  Write  with  Automatic  Sector 

Search 
Entire  Track  Write  for  Diskette  Formatting 

•  SYSTEM  COMPATIBILITY 

Double  Buffering  of  Data  8  Bit  Bt-Directional  Bus  for 

Data,  Control  and  Status 
DMA  or  Programmed  Data  Transfers 
All  I  nputs  and  Outputs  are  TTL  Compatible 
OrvChip  Track  and  Sector  Registers/Comprehensive 

Status  Information 


•  PROGRAMMABLE  CONTROLS 
Selectable  Track  to  Track  Stepping  Time 
Side  Select  Compare 

•  INTERFACES  TO  WD1691  DATA  SEPARATOR 

•  WINDOW  EXTENSION 

•  INCORPORATES  ENCODING/DECODING  AND 
ADDRESS  MARK  CIRCUITRY 

•  FD1 792/4  IS  SINGLE  DENSITY  ONLY 

•  FD1795T7  HAS  A  SIDE  SELECT  OUTPUT 

179X42  FAMILY  CHARACTERISTICS 


FEATURES 

1791 

1792 

1793 

1794 

1795 

1797 

Single  Density  (FM) 

X 

X 

X 

X 

X 

X 

Double  Density  (MFM) 

X 

X 

X 

X 

True  Data  Bus 

X 

X 

X 

Inverted  Data  Bus 

X 

X 

X 

Write  Precomp 

X 

X 

X 

X 

X 

X 

Side  Selection  Output 

X 

X 

APPLICATIONS 

8*  FLOPPY  AND5V«"  MINI  FLOPPY  CONTROLLER 
SINGLE  OR  DOUBLE  DENSITY 
CONTROLLER/FORMATTER 


^"""■"■N. 

u 


■1791/3=  FIG         1795/7=  SSO 
■1793/7  TflUE  BUS 
•1792MOPEN 

PIN  DESIGNATION 
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FD179X  SYSTEM  BLOCK  DIAGRAM 


November,  1982 


PIN  OUTS 


PIN 
NUMBER 

PIN  NAME 

SYMBOL 

FUNCTION 

1 
19 

NO  CONNECTION 

NC 
MR 

Pin  1  is  internally  connected  to  a  back  bias  generator  and 
must  be  left  open  by  the  user. 

A  logic  low  (50  microseconds  min.)  on  this  input  resets  the 
device  and  loads  HEX  03  into  the  command  register.  The  Not 
Ready  (Status  Bit  7)  is  reset  during  MR  ACTIVE.  When  MR  is 
brought  to  a  logic  high  a  RESTORE  Command  is  executed, 
regardless  of  the  state  of  the  Ready  signal  from  the  drive. 
Also,  HEX  01  is  loaded  into  sector  register. 

MASTER  RESET 

20 

POWER  SUPPLIES 

Vss 

Ground 

21 

Voc 

+  5V±5% 

40 

Vdd 

+  12V±5% 

COMPUTE 
2 

3 

4 

R  INTERFACE: 

WE 
CS 
RE 

A  logic  low  on  this  input  gates  data  on  the  DAL  into  the 
selected  register  when  CS  is  low. 

A  logic  low  on  this  Input  selects  the  chip  and  enables 
computer  communication  with  the  device. 

A  logic  low  on  this  input  controls  the  placement  of  data  from  a 
selected  register  on  the  DAL  when  CS  is  low. 

WRITE  ENABLE 

CHIP  SELECT 

READ ENABLE 

5,6 

REGISTER  SELECT  UNES 

A0.A1 

These  inputs  select  the  register  to  receive/transfer  data  on  the 
DAL  lines  under  RE  and  WE  control: 

CS     A1      A0                   RE                        WE 

7-14 

0        0        0              Status  Reg         Command  Reg 
0        0        1               Track  Reg          Track  Reg 
0        1        0              Sector  Reg        Sector  Reg 
0       11              Data  Reg           Data  Reg 

Eight  bit  Bidirectional  bus  used  for  transfer  of  data,  control, 
and  status.  This  bus  is  receiver  enabled  by  WE  or  transmitter 
enabled  by  RE.  Each  line  will  drive  1  standard  TTL  load. 

DATA  ACCESS  LINES 

DAL0-DAL7 

24 

CLOCK 

CLK 

This  input  requires  a  free-running  50%  duty  cycle  square  wave 
clock  for  internal  timing  reference,  2  MHz  ±  1%  for  8*  drives, 
1  MHz  ±1%  for  mini-floppies. 

38 

DATA  REQUEST 

DRQ 

This  open  drain  output  indicates  that  the  DR  contains 
assembled  data  in  Read  operations,  or  the  DR  is  empty  in 
Write  operations.  This  signal  Is  reset  when  serviced  by  the 
computer  through  reading  or  loading  the  DR  in  Read  or  Write 
operations,  respectively.  Use  10K  pull-up  resistor  to  +  5. 

39 
FLOPPY  D 

INTERRUPT  REQUEST 
ISK  INTERFACE: 

INTRQ 

This  open  drain  output  is  set  at  the  completion  of  any  com- 
mand and  is  reset  when  the  STATUS  register  is  read  or  the 
command  register  is  written  to.  Use  10K  pull-up  resistor  to 
+  5. 

15 

STEP 

STEP 

The  step  output  contains  a  pulse  for  each  step. 

16 

DIRECTION 

DtRC 

Direction  Output  is  active  high  when  stepping  in,  active  low 
when  stepping  out 

17 

EARLY 

EARLY 

Indicates  that  the  WRITE  DATA  pulse  occuring  while  Early  is 
active  (high)  should   be  shifted  early  for  write  precom- 
pensation. 

18 

LATE 

LATE 

Indicates  that  the  write  data  pulse  occurring  while  Late  is 
active  (high)  should  be  shifted  late  for  write  precompensation. 

o 
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PIN 
NUMBER 

PIN  NAME 

SYMBOL 

FUNCTION 

22 

TEST 

TEST 

This  input  is  used  for  testing  purposes  only  and  should  be  tied 
to  +  5V  or  left  open  by  the  user  unless  interfacing  to  voice  coil 
actuated  steppers. 

23 

HEAD  LOAD  TIMING 

HLT 

When  a  logic  high  is  found  on  the  HLT  input  the  head  is 
assumed  to  be  engaged.  It  is  typically  derived  from  a  1  shot 
triggered  by  HLD. 

25 

READ  GATE 

RG 

This  output  is  used  for  synchronization  of  external  data 

(1791, 1792, 1793, 1794) 

separators.  The  output  goes  high  after  two  Bytes  of  zeros  in 
single  density,  or  4  Bytes  of  either  zeros  or  ones  in  double 
density  operation. 

25 

SIDE  SELECT  OUTPUT 

SSO 

The  logic  level  of  the  Side  Select  Output  is  directly  controlled 

(1795, 1797) 

by  the 'S'  flag  in  Type  II  or  Ml  commands.  When  U  =  1,  SSO  is 
set  to  a  logic  1.  When  U  =  0,  SSO  is  set  to  a  logic  0.  The  SSO 
is  compared  with  the  side  information  in  the  Sector  I.D.  Field. 
If  they  do  not  compare  Status  Sit  4  (RNF)  is  set.  The  Side 
Select  Output  is  only  updated  at  the  beginning  of  a  Type  II  or 
III  command.  It  is  forced  to  a  logic  0  upon  a  MASTER  RESET 
condition. 

26 

READ  CLOCK 

RCLK 

A  nominal  square-wave  clock  signal  derived  from  the  data 
stream  must  be  provided  to  this  input.  Phasing  (i.e.  RCLK 
transitions)  relative  to  RAW  READ  is  important  but  polarity 

27 

(RCLK  high  or  low)  is  not. 

The  data  input  signal  directly  from  the  drive.  This  input  shall 

RAW  READ 

RAW  READ 

be  a  negative  pulse  for  each  recorded  flux  transition. 

28 

HEAD  LOAD 

HLD 

The  HLD  output  controls  the  loading  of  the  Read-Write  head 
against  the  media 

29 

TRACK  GREATER  THAN  43 

TG43 

This  output  informs  the  drive  that  the  Read/Write  head  is 
positioned  between  tracks  44-76.  This  output  is  valid  only 
during  Read  and  Write  Commands. 

30 

WRITE  GATE 

WG 

This  output  is  made  valid  before  writing  is  to  be  performed  on 
the  diskette. 

31 

WRITE  DATA 

WD 

A  200  ns  (MFM)  or  500  ns  (FM)  output  pulse  per  flux  transition. 
WD  contains  the  unique  Address  marks  as  well  as  data  and 
clock  in  both  FM  and  MFM  formats. 

32 

READY 

READY 

This  input  indicates  disk  readiness  and  is  sampled  for  a  logic 
high  before  Read  or  Write  commands  are  performed.  If  Ready 
is  low  the  Read  or  Write  operation  is  not  performed  and  an 
interrupt  is  generated.  Type  I  operations  are  performed 
regardless  of  the  state  of  Ready.  The  Ready  input  appears  in 

33 

inverted  format  as  Status  Register  bit  7. 

This  is  a  bi-directional  signal  used  to  signify  writing  faults  at 

WRITE  FAULT 

WF/VFOE 

VFO  ENABLE 

the  drive,  and  to  enable  the  external  PLO  data  separator.  When 
WG  =  1,  Pin  33  functions  as  a  WF  input.  If  WF  =  0,  any  write 
command  will  immediately  be  terminated.  When  WG  =  0,  Pin 
33  functions  as  a  VFOE  output.  VFOE  will  go  low  during  a  read 
operation  after  the  head  has  loaded  and  settled  (HLT  =  1).  On 
the  1795/7,  it  will  remain  low  until  the  last  bit  of  the  second 
CRC  byte  in  the  ID  field.  VFOE  will  then  go  high  until  8  bytes 
(MFM)  or  4  bytes  (FM)  before  the  Address  Mark.  It  will  then  go 
active  until  the  last  bit  of  the  second  CRC  byte  of  the  Data 
Field.  On  the  1791/3,  VFOE  will  remain  low  until  the  end  of  the 

34 

TROO 

Data  Field.  This  pin  has  an  internal  100K  Ohm  pull-up  resistor. 
This  input  informs  the  FD179X  that  the  Read/Write  head  is 

TRACK 00 

positioned  over  Track  00. 

PIN  NUMBER 

PIN  NAME 

SYMBOL 

FUNCTION 

35 
36 

37 

IP 

This  input  informs  the  FD179X  when  the  index  hole  is  en- 
countered on  the  diskette. 

This  input  is  sampled  whenever  a  Write  Command  is  received. 
A  logic  low  terminates  the  command  and  sets  the  Write 
Protect  Status  bit. 

This   input   pin   selects  either  single  or  double  density 
operation.  When  DDEN  =  0,  double  density  is  selected.  When 
DDEN  =  1,  single  density  is  selected.  This  line  must  be  left 
open  on  the  1792/4. 

INDEX  PULSE 

WRITE  PROTECT 

WPRT 

DOUBLE  DENSITY 

DDEN 

GENERAL  DESCRIPTION 

The  FD179X  are  N-Channel  Silicon  Gate  MOS  LSI 
devices  which  perform  the  functions  of  a  Floppy  Disk 
Formatter/Controller  in  a  single  chip  implementation. 
The  FD179X,  which  can  be  considered  the  end  result 
of  both  the  FD1771  and  FD1781  designs,  is  IBM  3740 
compatible  in  single  density  mode  (FM)  and  System  34 
compatible  in  Double  Density  Mode  (MFM).  The 
FD179X  contains  all  the  features  of  its  predecessor  the 
FD1771,  plus  the  added  features  necessary  to 
read/write  and  format  a  double  density  diskette.  These 
include  address  mark  detection,  FM  and  MFM  encode 
and  decode  logic,  window  extension,  and  write  precom- 
pensation.  In  order  to  maintain  compatibility,  the 
FD1771,  FD1781,  and  FD179X  designs  were  made  as 
close  as  possible  with  the  computer  interface,  instruc- 
tion set,  and  I/O  registers  being  identical.  Also,  head 
load  control  is  identical.  In  each  case,  the  actual  pin 
assignments  vary  by  only  a  few  pins  from  any  one  to 
another. 

The  processor  interface  consists  of  an  8-bit  bi-direc- 
tional bus  for  data,  status,  and  control  word  transfers. 
The  FD179X  is  set  up  to  operate  on  a  multiplexed  bus 
with  other  bus-oriented  devices. 

The  FD179X  is  TTL  compatible  on  all  inputs  and 
outputs.  The  outputs  will  drive  ONE  TTL  load  or  three 
LS  loads.  The  1793  is  identical  to  the  1791  except  the 
DAL  lines  are  TRUE  for  systems  that  utilize  true  data 
busses. 

The  1795/7  has  a  side  select  output  for  controlling 
double  sided  drives,  and  the  1792  and  1794  are  "Single 
Density  Only"  versions  of  the  1791  and  1793  respec- 
tively. On  these  devices,  DDEN  must  be  left  open. 

ORGANIZATION 

The  Floppy  Disk  Formatter  block  diagram  is  illustrated 
on  page  5.  The  primary  sections  include  the  parallel 
processor  interface  and  the  Floppy  Disk  interface. 

Data  Shift  Register  —  This  8-bit  register  assembles 
serial  data  from  the  Read  Data  input  (RAW  READ) 
during  Read  operations  and  transfers  serial  data  to  the 
Write  Data  output  during  Write  operations. 
Data  Register  —  This  8-bit  register  is  used  as  a 
holding  register  during  Disk  Read  and  Write  operations. 
In  Disk  Read  operations  the  assembled  data  byte  is 
transferred  in  parallel  to  the  Data  Register  from  the 
Data  Shift  Register.  In  Disk  Write  operations  in- 
formation is  transferred  in  parallel  from  the  Data 
Register  to  the  Data  Shift  Register. 


When  executing  the  Seek  command  the  Data  Register 
holds  the  address  of  the  desired  Track  position.  This 
register  is  loaded  from  the  DAL  and  gated  onto  the 
DAL  under  processor  control. 

Track  Register  —  This  8-bit  register  holds  the  track 
number  of  the  current  Read/Write  head  position.  It  is 
incremented  by  one  every  time  the  head  is  stepped  in 
(towards  track  76)  and  decremented  by  one  when  the 
head  is  stepped  out  (towards  track  00).  The  contents  of 
the  register  are  compared  with  the  recorded  track 
number  in  the  ID  field  during  disk  Read,  Write,  and 
Verify  operations.  The  Track  Register  can  be  loaded 
from  or  transferred  to  the  DAL  This  Register  should 
not  be  loaded  when  the  device  is  busy. 
Sector  Register (SR)  —  This  8-bit  register  holds  the  address 
of  the  desired  sector  position.  The  contents  of  the  register 
are  compared  with  the  recorded  sector  number  in  the  ID 
field  during  disk  Read  or  Write  operations.  The  Sector 
Register  contents  can  be  loaded  from  or  transferred  to  the 
DAL  This  register  should  not  be  loaded  when  the  device  is 
busy. 

Command  Register  (CR)  —  This  8-bit  register  holds  the 
command  presently  being  executed.  This  register  should 
not  be  loaded  when  the  device  is  busy  unless  the  new 
command  is  a  force  interrupt.  The  command  register  can 
be  loaded  from  the  DAL,  but  not  read  onto  the  DAL 
Status  Register  (STR)  —  This  8-bit  register  holds  device 
Status  information.  The  meaning  of  the  Status  bits  is  a 
function  of  the  type  of  command  previously  executed.  This 
register  can  be  read  onto  the  DAL  but  not  loaded  from  the 
DAL 

CRC  Logic  —  This  logic  is  used  to  check  or  to  generate  the 
16-bit  Cyclic  Redundancy  Check  (CRC).  The  polynomial  is: 
G(x)  =  x"  +  x"  +  xs  +  1. 

The  CRC  includes  all  information  starting  with  the  address 
mark  and  up  to  the  CRC  characters.  The  CRC  register  is 
preset  to  ones  prior  to  data  being  shifted  through  the 
circuit. 

Arithmetic/Logic  Unit  (ALU)  —  The  ALU  is  a  serial  com- 
parator, incrementer,  and  decrementer  and  is  used  for 
register  modification  and  comparisons  with  the  disk 
recorded  ID  field. 

Timing  and  Control  —  All  computer  and  Floppy  Disk  In- 
terface controls  are  generated  through  this  logic.  The  in- 
ternal device  timing  is  generated  from  an  external  crystal 
clock. 

The  FD179X  has  two  different  modes  of  operation  ac- 
cording to  the  state  of  DDEN.  When  DDEN  =  0  double 
density  (MFM)  is  assumed.  When  DDEN   =    1,  single 
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density  (FM)  is  assumed.  1792  &  1794  are  single  density 
only. 

AM  Detector  —  The  address  mark  detector  detects  ID,  data 
and  index  address  marks  during  read  and  write  operations. 

PROCESSOR  INTERFACE 

The  interface  to  the  processor  is  accomplished  through  the 
eight  Data  Access  Lines  (DAL)  and  associated  control 
signals.  The  DAL  are  used  to  transfer  Data,  Status,  and 
Control  words  out  of,  or  Into  the  FD179X.  The  DAL  are  three 
state  buffers  that  are  enabled  as  output  drivers  when  Chip 
Select  (CS)  and  Read  Enable  (RE)_are  active  (low  logic  state) 
or  act  as  input  receivers  when  CS  and  Write  Enable  (WE) 
are  active. 

When  transfer  of  data  with  the  Floppy  Disk  Controller  is 
required  by  the  host  processor,  the  device  address  is 
decoded  and  CS  is  made  low.  The  address  bits  A1  and  AO, 
combined  with  the  signals  RE  during  a  Read  operation  or 
WE  during  a  Write  operation  are  interpreted  as  selecting 
the  following  registers: 


A1  -  AO 


READ  (RE) 


WRITE  (WE) 


0  0  Status  Register 

0  1  Track  Register 

1  0  Sector  Register 
1  1  Data  Register 


Command  Register 
Track  Register 
Sector  Register 
Data  Register   


During  Direct  Memory  Access  (DMA)  types  of  data 
transfers  between  the  Data  Register  of  the  FD179X  and  the 
processor,  the  Data  Request  (DRQ)  output  is  used  in  Data 
Transfer  control.  This  signal  also  appears  as  status  bit  1 
during  Read  and  Write  operations. 

On  Disk  Read  operations  the  Data  Request  is  activated  (set 
high)  when  an  assembled  serial  input  byte  is  transferred  in 
parallel  to  the  Data  Register.  This  bit  is  cleared  when  the 
Data  Register  is  read  by  the  processor.  If  the  Data  Register 
is  read  after  one  or  more  characters  are  lost,  by  having  new 
data  transferred  into  the  register  prior  to  processor  readout, 
the  Lost  Data  bit  is  set  in  the  Status  Register.  The  Read 
operation  continues  until  the  end  of  sector  is  reached. 

On  Disk  Write  operations  the  data  Request  is  activated 
when  the  Data  Register  transfers  its  contents  to  the  Data 


Shift  Register,  and  requires  a  new  data  byte.  It  is  reset 

when  the  Data  Register  is  loaded  with  new  data  by  the 

processor.  If  new  data  is  not  loaded  at  the  time  the  next 

serial  byte  is  required  by  the  Floppy  Disk,  a  byte  of  zeroes 

is  written  on  the  diskette  and  the  Lost  Data  bit  is  set  in  the 

Status  Register. 

At   the  completion   of   every   command  an   INTRQ  is 

generated.  INTRQ  is  reset  by  either  reading  the  status 

register  or  by  loading  the  command  register  with  a  new 

command.  In  addition,  INTRQ  is  generated  it  a  Force 

Interrupt  command  condition  is  met. 

The  179X  has  two  modes  of  operation  according  to  the 

state  of  DDEN  (Pin  37).  When  DDEN  =  1,  single  density  is 

selected.  In  either  case,  the  CLK  input  (Pin  24)  is  at  2  MHz. 

However,  when  interfacing  with  the  mini-floppy,  the  CLK 

input  is  set  at  1  MHz  for  both  single  density  and  double 

density. 

GENERAL  DISK  READ  OPERATIONS 

Sector  lengths  of  128,  256,  512  or  1024  are  obtainable  in 

either  FM  or  MFM  formats.  For  FM,  DDEN  should  be 

placed  to  logical  "1."  For  MFM  formats,  DDEN  should  be 

placed  to  a  logical  "0."  Sector  lengths  are  determined  at 

format  time  by  the  fourth  byte  in  the  "ID"  field. 


Sector  Length  Table* 


Sector  Length 
Field  (hex) 


Number  of  Bytes 
in  Sector  (decimal) 


00 
01 
02 

03 


128 

256 

512 

1024 


"1795/97  may  vary  —  see  command  summary. 
The  number  of  sectors  per  track  as  far  as  the  FD179X  is 
concerned  can  be  from  1  to  255  sectors.  The  number  of 
tracks  as  far  as  the  FD179X  is  concerned  is  from  0  to  255 
tracks.  For  IBM  3740  compatibility,  sector  lengths  are  128 
bytes  with  26  sectors  per  track.  For  System  34  com- 
patibility (MFM),  sector  lengths  are  256  bytes/sector  with  26 
sectors/track;  or  lengths  of  1024  bytes/sector  with  8 
sectors/track.  (See  Sector  Length  Table) 
For  read  operations  in  8"  double  density  the  FD179X 
requires  RAW  READ  Data  (Pin  27)  signal  which  is  a  200  ns 
pulse  per  flux  transition  and  a  Read  clock  (RCLK)  signal  to 
indicate  flux  transition  spacings.  The  RCLK  (Pin  26)  signal 
is  provided  by  some  drives  but  if  not  it  may  be  derived 
externally  by  Phase  lock  loops,  one  shots,  or  counter 
techniques.  In  addition,  a  Read  Gate  Signal  is  provided  as 
an  output  (Pin  25)  on  1791/92/93/94  which  can  be  used  to 
inform  phase  lock  loops  when  to  acquire  synchronization. 
When  reading  from  the  media  in  FM.  RG  is  made  true  when 
2  bytes  of  zeroes  are  detected.  The  FD179X  must  find  an 
address  mark  within  the  next  10  bytes;  otherwise  RG  is 
reset  and  the  search  for  2  bytes  of  zeroes  begins  all  over 
again.  If  an  address  mark  is  found  within  10  bytes,  RG 
remains  true  as  long  as  the  FD179X  is  deriving  any  useful 
information  from  the  data  stream.  Similarly  for  MFM,  RG  is 
made  active  when  4  bytes  of  "00"  or  "FF'  are  detected.  The 
FD179X  must  find  an  address  mark  within  the  next  16 
bytes,  otherwise  RG  is  reset  and  search  resumes. 
During  read  operations  <WG  =  0),  the  VFOE  (Pin  33)  is 
provided  for  phase  lock  loop  synchronization.  VFOE  will  go 
active  low  when: 


a)  Both  HLT  and  HLD  are  True 

b)  Settling  Time,  if  programmed,  has  expired 

c)  The  1 79X  is  inspecting  data  off  the  disk 

If  WF/VFOE  is  not  used,  leave  open  or  tie  to  a  1 0K  resistor 

to +5. 

GENERAL  DISK  WRITE  OPERATION 

When  writing  is  to  take  place  on  the  diskette  the  Write  Gate 
(WG)  output  is  activated,  allowing  current  to  flow  into  the 
Read/Write  head.  As  a  precaution  to  erroneous  writing  the 
first  data  byte  must  be  loaded  into  the  Data  Register  in 
response  to  a  Data  Request  from  the  FD179X  before  the 
Write  Gate  signal  can  be  activated. 
Writing  is  inhibited  when  the  Write  Protect  input  is  a  logic 
low,  in  which  case  any  Write  command  is  immediately 
terminated,  an  interrupt  is  generated  and  the  Write  Protect 
status  bit  is  set.  The  Write  Fault  input,  when  activated, 
signifies  a  writing  fault  condition  detected  in  disk  drive 
electronics  such  as  failure  to  detect  write  current  flow 
when  the  Write  Gate  is  activated.  On  detection  of  this  fault 
the  FD179X  terminates  the  current  command,  and  sets  the 
Write  Fault  bit  (bit  5)  in  the  Status  Word.  The  Write  Fault 
input  should  be  made  inactive  when  the  Write  Gate  output 
becomes  inactive. 

For  write  operations,  the  FD179X  provides  Write  Gate  (Pin 
30)  and  Write  Data  (Pin  31)  outputs.  Write  data  consists  of  a 
series  of  500  ns  pulses  in  FM  (DDEN  =  1)  and  200  ns 
pulses  in  MFM  (DDEN  =  0).  Write  Data  provides  the  unique 
address  marks  in  both  formats. 

Also  during  write,  two  additional  signals  are  provided  for 
write  precompensation.  These  are  EARLY  (Pin  17)  and 
LATE  (Pin  18).  EARLY  is  active  true  when  the  WD  pulse 
appearing  on  (Pin  30)  is  to  be  written  EARLY.  LATE  is  active 
true  when  the  WD  pulse  is  to  be  written  LATE.  If  both 
EARLY  and  LATE  are  low  when  the  WD  pulse  is  present, 
the  WD  pulse  is  to  be  written  at  nominal.  Since  write 
precompensation  values  vary  from  disk  manufacturer  to 
disk  manufacturer,  the  actual  value  is  determined  by 
several  one  shots  or  delay  lines  which  are  located  external 
to  the  FD179X.  The  write  precompensation  signals  EARLY 
and  LATE  are  valid  for  the  duration  of  WD  in  both  FM  and 
MFM  formats. 

READY 

Whenever  a  Read  or  Write  command  (Type  II  or  III)  is 
received  the  FD179X  samples  the  Ready  input.  If  this  input 
is  logic  low  the  command  is  not  executed  and  an  interrupt 
is  generated.  All  Type  I  commands  are  performed  re 
gardless  of  the  state  of  the  Ready  input.  Also,  whenever  a 
Type  II  or  III  command  is  received,  the  TG43  signal  output 
is  updated. 

COMMAND  DESCRIPTION 

The  FD179X  will  accept  eleven  commands.  Command 
words  should  only  be  loaded  in  the  Command  Register 
when  the  Busy  status  bit  is  off  (Status  bit  0).  The  one 
exception  is  the  Force  Interrupt  command.  Whenever  a 
command  is  being  executed,  the  Busy  status  bit  is  set. 
When  a  command  is  completed,  an  interrupt  is  generated 
and  the  Busy  status  bit  is  reset.  The  Status  Register 
indicates  whether  the  completed  command  encountered 
an  error  or  was  fault  free.  For  ease  of  discussion, 
commands  are  divided  into  four  types.  Commands  and 
types  are  summarized  in  Table  1 . 
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TABLE  1.    COMMAND  SUMMARY 


A.  Commands  for  Models:  1791. 1792, 1793, 1794 

B.  Commands  for  Models:  1795, 1797 

Bits 

Bits 

Type  Command 

7        6        5 

4 

3 

2 

1 

0 

7        6        5        4        3        2        1 

0 

I     Restore 

0        0        0 

0 

h 

V 

n 

"0 

0        0        0        0        h        V       f1 

■"0 

I     Seek 

0        0        0 

1 

h 

V 

'1 

ro 

0       0       0        1        h       v       n 

ro 

I     Step 

0       0        1 

T 

h 

V 

n 

f0 

0       0       1       T       h       v      n 

■•o 

I     Step-in 

0        1        0 

T 

h 

V 

H 

TO 

0        1        0       T        h       V       ri 

TO 

I     Step-out 

0        1        1 

T 

h 

V 

'1 

TO 

0        1        1        T        h       V       1*1 

'0 

II    Read  Sector 

1        0        0 

m 

S 

E 

C 

0 

1        0        0       m       L        E       U 

0 

II    Write  Sector 

1        0        1 

m 

S 

E 

C 

an 

1        0         1        m       L        E        U 

an 

Itl    Read  Address 

1         1        0 

0 

0 

E 

0 

0 

1         1         0        0        0        E        U 

0 

III    Read  Track 

1      1      1 

0 

0 

E 

0 

0 

1         1         1        0        0        E        U 

0 

III   Write  Track 

1       1       1 

1 

0 

e 

0 

0 

1         1         1         1        0        E        U 

0 

IV    Force  Interrupt 

1         1        0 

1 

l3 

<2 

h 

k> 

1         1         0        1        '3       '2       '1 
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TABLE  2.  FLAG  SUMMARY 


Command 
Type 

Bit 

No(s) 

Description 

I 

0,1 

r1  ^O  =  Stepping  Motor  Rate 
See  Table  3  for  Rate  Summary 

I 

2 

V  =  Track  Number  Verify  Flag 

V  =  0,  No  verify 

V  =  1,  Verify  on  destination  track 

t 

3 

h  =  Head  Load  Flag 

h   =  1,  Load  head  at  beginning 
h   =  0,  Unload  head  at  beginning 

1 

4 

T  =  Track  Update  Flag 

T   =  0,  No  update 

T   =  1,  Update  track  register 

H 

0 

ao  =  Data  Address  Mark 

a0=0,FB(DAM) 

ao=  1.F8  (deleted  DAM) 

H 

1 

C  =  Side  Compare  Flag 

C  =  0,  Disable  side  compare 
C  =  1,  Enable  side  compare 

II  &  111 

1 

U  =  Update  SSO 

U  =0,  Update  SSO  toO 
U  =  1,  Update  SSO  to  1 

II  &  III 

2 

E=  15  MS  Delay 

E   =0,  No  15  MS  delay 
E   =  1,15  MS  delay 

H 
H 

N 

3 
3 

4 

S  =  Side  Compare  Flag 
L  =  Sector  Length  Flag 

m  =  Multiple  Record  Flag 

S   =  0,  Compare  for  side  0 
S   =  1,  Compare  for  side  1 

LSB's  Sector  Length  in  ID  Field 
00             01              10             11 

L    =  0             256            512           1024            128 

L   =  1             128            256             512           1024 

m  =  0,  Single  record 
m  =  1,  Multiple  records 

IV 

0-3 

•x         =  Interrupt  Condition  Flags 

'0         =  1  Not  Ready  To  Ready  Transition 

h         =1  Ready  To  Not  Ready  Transition 

'2         =  1 1ndex  Pulse 

'3         =1  Immediate  Interrupt,  Requires  A  Reset 

'3-'0     =  0  Terminate  With  No  I  nterrupt  (I  NTRQ) 

'NOTE:  See  Type  IV  Command  Description  for  further  information. 


TYPE  I  COMMANDS 

The  Type  I  Commands  include  the  Restore,  Seek,  Step, 
Step-in,  and  Step-Out  commands.  Each  of  the  Type  I 
Commands  contains  a  rate  field  (fQ  1),  which  determines 
the  stepping  motor  rate  as  defined  in  Table  3. 
A  2  »4S  (MFM)  or  4  fis  <FM)  pulse  is  provided  as  an  output  to 
the  drive.  For  every  step  pulse  issued,  the  drive  moves  one 
track  location  in  a  direction  determined  by  the  direction 
output.  The  chip  will  step  the  drive  in  the  same  direction  it 
last  stepped  unless  the  command  changes  the  direction. 
The  Direction  signal  is  active  high  when  stepping  in  and 
low  when  stepping  out.  The  Direction  signal  is  valid  12  jjs 
before  the  first  stepping  pulse  is  generated. 

The  rates  (shown  in  Table  3)  can  be  applied  to  a  Step- 
Direction  Motor  through  the  device  interface. 


TABLE  a  STEPPING  RATES 

CLK 

2  MH2 

2  MHz 

1  MH2 

1  MHz 

2  MHz 

1  MHz 

DDEN 

0 

1 

0 

1 

X 

X 

R1  RO 

TEST=1 

TESTo 

TESTO 

TEST=1 

TEST=0 

TEST^O 

0    0 

3  ms 

3  ms 

6  ms 

6  ms 

184»is 

368pS 

0     1 

6  ms 

6  ms 

12  ms 

12  ms 

190*ts 

36(Vs 

1     0 

10  ms 

10  ms 

20  ms 

20  ms 

198(is 

396/iS 

1     1 

15  ms 

15  ms 

30  ms 

30  ms 

208jis 

416jis 

After  the  last  directional  step  an  additional  15  milliseconds 
of  head  settling  time  takes  place  if  the  Verify  flag  is  set  in 
Type  I  commands.  Note  that  this  time  doubles  to  30  ms  for 
a  1  MHz  clock.  If  TEST  =  0,  there  is  zero  settling  time. 
There  is  also  a  15  ms  head  settling  time  if  the  E  flag  is  set  in 
any  Type  II  or  III  command. 

When  a  Seek,  Step  or  Restore  command  is  executed  an 
optional  verification  of  Read-Write  head  position  can  be 
performed  by  settling  bit  2{V  =  1)  in  the  command  word  to 
a  logic  1 .  The  verification  operation  begins  at  the  end  of  the 
15  millisecond  settling  time  after  the  head  is  loaded  against 
the  media  The  track  number  from  the  first  encountered  ID 
Field  is  compared  against  the  contents  of  the  Track 
Register.  If  the  track  numbers  compare  and  the  ID  Field 
Cyclic  Redundancy  Check  (CRC)  is  correct,  the  verify 
operation  is  complete  and  an  INTRQ  is  generated  with  no 
errors.  If  there  is  a  match  but  not  a  valid  CRC,  the  CRC  error 
status  bit  is  set  (Status  bit  3),  and  the  next  encountered  ID 
field  is  read  from  the  disk  for  the  verification  operation. 

The  FD179X  must  find  an  ID  field  with  correct  track  number 
and  correct  CRC  within  5  revolutions  of  the  media; 
otherwise  the  seek  error  is  set  and  an  INTRQ  is  generated, 
tf  V  =  0,  no  verification  is  performed. 

The  Head  Load  (HLD)  output  controls  the  movement  of  the 
read/write  head  against  the  media  HLD  is  activated  at  the 
beginning  of  a  Type  I  command  if  the  h  flag  is  set  (h  =  1),  at 
the  end  of  the  Type  I  command  if  the  verify  flag  (V  =  1),  or 
upon  receipt  of  any  Type  II  or  III  command.  Once  HLD  is 
active  it  remains  active  until  either  a  Type  I  command  is 
received  with  (h  =  0  and  V  =  0);  or  if  the  FD179X  is  in  an 
idle  state  (non-busy)  and  15  index  pulses  have  occurred. 


Head  Load  timing  (HLT)  is  an  input  to  the  FD179X  which  is 
used  for  the  head  engage  time.  When  H  LT  =  1 ,  the  FD1 79X 
assumes  the  head  is  completely  engaged.  The  head 
engage  time  is  typically  30  to  100  ms  depending  on  drive. 
The  low  to  high  transition  on  HLD  is  typically  used  to  fire  a 
one  shot.  The  output  of  the  one  shot  is  then  used  for  HLT 
and  supplied  as  an  input  to  the  FD179X. 
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HLT  (FROM  ONE  SHOT) 


HEAD  LOAD  TIMING 

When  both  HLD  and  HLT  are  true,  the  FD179X  will  then 
read  from  or  write  to  the  media  The  "and"  of  HLD  and  HLT 
appears  as  status  Bit  5  in  Type  I  status. 

In  summary  for  the  Type  I  commands:  if  h  =  0  and  V  =  0, 
HLD  is  reset.  If  h  =  1  and  V  =  0,  HLD  is  set  at  the 
beginning  of  the  command  and  HLT  is  not  sampled  nor  is 
there  an  internal  15  ms  delay.  If  h  =  0  and  V  =  1,  HLD  is 
set  near  the  end  of  the  command,  an  internal  15  ms  occurs, 
and  the  FD179X  waits  for  HLT  to  be  true.  If  h  =  1  and  V  = 
1,  HLD  is  set  at  the  beginning  of  the  command.  Near  the 
end  of  the  command,  after  all  the  steps  have  been  issued, 
an  internal  15  ms  delay  occurs  and  the  FD179X  then  waits 
for  HLT  to  occur. 

For  Type  II  and  III  commands  with  E  flag  off,  HLD  is  made 
active  and  HLT  is  sampled  until  true.  With  E  flag  on,  HLD  is 
made  active,  an  internal  15  ms  delay  occurs  and  then  HLT 
is  sampled  until  true. 

RESTORE  (SEEK  TRACK  0) 
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Upon  receipt  of  this  command  the  Track  00  (TROO)  input  is 
sampled.  If  TROO  is  active  low  indicating  the  Read-Write 
head  is  positioned  over  track  0,  the  Track  Register  is  loaded 
with  zeroes  and  an  interrupt  is  generated.  If  TROO  is  not 
active  low,  stepping  pulses  (pins  15  to  16)  at  a  rate  specified 
by  the  ri  r0  field  are  issued  until  the  TROO  input  is  activated. 
At  this  time  the  Track  Register  is  loaded  with  zeroes  and  an 
interrupt  is  generated.  If  the  TROO  input  does  not  go  active 
low  after  255  stepping  pulses,  the  FD179X  terminates 
operation,  interrupts,  and  sets  the  Seek  error  status  bit, 
providing  the  V  flag  is  set.  A  verification  operation  also 
takes  place  if  the  V  flag  is  set.  The  h  bit  allows  the  head  to 
be  loaded  at  the  start  of  command.  Note  that  the  Restore 
command  is  executed  when  MR  goes  from  an  active  to  an 
inactive  state  and  that  the  DRQ  pin  stays  low. 

SEEK 

This  command  assumes  that  the  Track  Register  contains 
the  track  number  of  the  current  position  of  the  Read-Write 
head  and  the  Data  Register  contains  the  desired  track 
number.  The  FD179X  will  update  the  Track  register  and 
issue  stepping  pulses  in  the  appropriate  direction  until  the 
contents  of  the  Track  register  are  equal  to  the  contents  of 
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TYPE  I  COMMAND  FLOW 

the  Data  Register  (the  desired  track  location).  A  verification 
operation  takes  place  if  the  V  flag  is  on.  The  h  bit  allows  the 
head  to  be  loaded  at  the  start  of  the  command.  An  interrupt 
is  generated  at  the  completion  of  the  command.  Note: 
When  using  multiple  drives,  the  track  register  must  be 
updated  for  the  drive  selected  before  seeks  are  issued. 

STEP 

Upon  receipt  of  this  command,  the  FD179X  issues  one 
stepping  pulse  to  the  disk  drive.  The  stepping  motor 
direction  is  the  same  as  in  the  previous  step  command. 
After  a  delay  determined  by  the  r1r0  field,  a  verification 
takes  place  if  the  V  flag  is  on.  If  the  U  flag  is  on,  the  Track 
Register  is  updated.  The  h  bit  allows  the  head  to  be  loaded 
at  the  start  of  the  command.  An  interrupt  is  generated  at 
the  completion  of  the  command. 

STEP-IN 

Upon  receipt  of  this  command,  the  FD179X  issues  one 
stepping  pulse  in  the  direction  towards  track  76.  If  the  U 
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TYPE  I  COMMAND  FLOW 

flag  is  on,  the  Track  Register  is  incremented  by  one.  After  a 
delay  determined  by  the  r1  r0  field,  a  verification  takes  place 
if  the  V  flag  is  on.  The  h  bit  allows  the  head  to  be  loaded  at 
the  start  of  the  command.  An  interrupt  is  generated  at  the 
completion  of  the  command. 

STEP-OUT 

Upon  receipt  of  this  command,  the  F0179X  issues  one 
stepping  pulse  in  the  direction  towards  track  0.  If  the  U  flag 
is  on,  the  Track  Register  is  decremented  by  one.  After  a 
delay  determined  by  the  r1  r0  field,  a  verification  takes  place 
if  the  V  flag  is  on.  The  h  bit  allows  the  head  to  be  loaded  at 
the  start  of  the  command.  An  interrupt  is  generated  at  the 
completion  of  the  command. 

EXCEPTIONS 

On  the  1795/7  devices,  the  SSO  output  is  not  affected 
during  Type  1  commands,  and  an  internal  side  compare 
does  not  take  place  when  the  (V)  Verify  Flag  is  on. 
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TYPE  I  COMMAND  FLOW 

TYPED  COMMANDS 

The  Type  II  Commands  are  the  Read  Sector  and  Write 
Sector  commands.  Prior  to  loading  the  Type  II  Command 
into  the  Command  Register,  the  computer  must  load  the 
Sector  Register  with  the  desired  sector  number.  Upon 
receipt  of  the  Type  II  command,  the  busy  status  Bit  is  set.  If 
the  E  flag  =  1  (this  is  the  normal  case)  HLD  is  made  active 
and  HLT  is  sampled  after  a  15  msec  delay.  If  the  E  flag  is  0, 
the  head  is  loaded  and  HLT  sampled  with  no  15  msec 
delay.  The  ID  field  and  Data  Field  format  are  shown  on  page 
13. 

When  an  ID  field  is  located  on  the  disk,  the  FD179X 
compares  the  Track  Number  on  the  ID  field  with  the  Track 
Register.  If  there  is  not  a  match,  the  next  encountered  ID 
field  is  read  and  a  comparison  is  again  made.  If  there  was  a 
match,  the  Sector  Number  of  the  ID  field  is  compared  with 
the  Sector  Register.  If  there  is  not  a  Sector  match,  the  next 
encountered  ID  field  is  read  off  the  disk  and  comparisons 
again  made.  If  the  ID  field  CRC  is  correct,  the  data  field  is 


then  located  and  will  be  either  written  into,  or  read  from 
depending  upon  the  command.  The  FD179X  must  find  an 
ID  field  with  a  Track  number,  Sector  number,  side  number, 
and  CRC  within  four  revolutions  of  the  disk;  otherwise,  the 
Record  not  found  status  bit  is  set  (Status  bit  3)  and  the 
command  is  terminated  with  an  interrupt. 
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TYPE  It  COMMAND 

Each  of  the  Type  II  Commands  contains  an  (m)  flag  which 
determines  if  multiple  records  (sectors)  are  to  be  read  or 
written,  depending  upon  the  command.  If  m  =  0,  a  single 
sector  is  read  or  written  and  an  interrupt  is  generated  at  the 
completion  of  the  command.  If  m  =  1,  multiple  records  are 
read  or  written  with  the  sector  register  internally  updated 
so  that  an  address  verification  can  occur  on  the  next 


W 


10 


record.  The  FD179X  will  continue  to  read  or  write  multiple 
records  and  update  the  sector  register  in  numerical 
ascending  sequence  until  the  sector  register  exceeds  the 
number  of  sectors  on  the  track  or  until  the  Force  Interrupt 
command  is  loaded  into  the  Command  Register,  which 
terminates  the  command  and  generates  an  interrupt 

For  example:  If  the  FD179X  is  instructed  to  read  sector  27 
and  there  are  only  26  on  the  track,  the  sector  register  ex- 
ceeds the  number  available.  The  FD179X  will  search  for  5 
disk  revolutions,  interrupt  out,  reset  busy,  and  set  the 
record  not  found  status  bit. 

The  Type  II  commands  for  1791-94  also  contain  side  select 
compare  flags.  When  C  =  0  (Bit  1)  no  side  comparison  is 
made.  When  C  =  1,  the  LSB  of  the  side  number  is  read  off 
the  ID  Field  of  the  disk  and  compared  with  the  contents  of 
the  (S)  flag  (Bit  3).  If  the  S  flag  compares  with  the  side 
number  recorded  in  the  ID  field,  the  FD179X  continues  with 
the  ID  search.  If  a  comparison  is  not  made  within  5  index 
pulses,  the  interrupt  line  is  made  active  and  the  Record- 
Not-Found  status  bit  is  set. 


M*Tflo  reset  bust 
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The  Type  II  and  III  commands  for  the  179S97  contain  a  side 
select  flag  (Bit  1).  When  U  =  0,  SSO  is  updated  to  0. 
Similarly,  U  =  1  updates  SSO  to  1.  The  chip  compares  the 
SSO  to  the  ID  field.  If  they  do  not  compare  within  5 
revolutions  the  interrupt  line  is  made  active  and  the  RNF 
status  bit  is  set. 

The  1795tf  READ  SECTOR  and  WRITE  SECTOR  com- 
mands include  a  'L'  flag.  The  'L'  flag,  in  conjunction  with 
the  sector  length  byte  of  the  ID  Field,  allows  different  byte 
lengths  to  be  implemented  in  each  sector. '  For  IBM 
compatability,  the  'L'  flag  should  be  set  to  a  one. 

READ  SECTOR 

Upon  receipt  of  the  Read  Sector  command,  the  head  is 
loaded,  the  Busy  status  bit  set,  and  when  an  ID  field  is 
encountered  that  has  the  correct  track  number,  correct 
sector  number,  correct  side  number,  and  correct  CRC,  the 
data  field  is  presented  to  the  computer.  The  Data  Address 
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WRITE  SECTOR 
SEQUENCE 
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TYPE  II  COMMAND 

Mart  of  the  data  field  must  be  found  within  30  bytes  in 
single  density  and  43  bytes  in  double  density  of  the  last  ID 
field  CRC  byte;  if  not,  the  ID  field  is  searched  for  and 
verified  again  followed  by  the  Data  Address  Mark  search.  If 
after  5  revolutions  the  DAM  cannot  be  found,  the  Record 
Not  Found  status  bit  is  set  and  the  operation  is  terminated. 
When  the  first  character  or  byte  of  the  data  field  has  been 
shifted  through  the  DSR,  it  is  transferred  to  the  DR,  and 
DRQ  is  generated.  When  the  next  byte  is  accumulated  in 
the  DSR,  it  is  transferred  to  the  DR  and  another  DRQ  is 
generated.  If  the  Computer  has  not  read  the  previous 
contents  of  the  DR  before  a  new  character  is  transferred 
that  character  is  lost  and  the  Lost  Data  Status  bit  is  set. 
This  sequence  continues  until  the  complete  data  field  has 
been  inputted  to  the  computer.  If  there  is  a  CRC  error  at  the 
end  of  the  data  field,  the  CRC  error  status  bit  is  set,  and  the 
command  is  terminated  (even  if  it  is  a  multiple  record 
command). 

At  the  end  of  the  Read  operation,  the  type  of  Data  Address 
Mark  encountered  in  the  data  field  is  recorded  in  the  Status 
Register  (Bit  5)  as  shown: 


STATUS 
BIT  5 


Deleted  Data  Mark 
Data  Mark 
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0 

WRITE  SECTOR 

Upon  receipt  of  the  Write  Sector  command,  the  head  is 
loaded  (HLD  active)  and  the  Busy  status  bit  is  set  When  an 
ID  field  is  encountered  that  has  the  correct  track  number, 
correct  sector  number,  correct  side  number,  and  correct 
CRC,  a  DRQ  is  generated.  The  FD179X  counts  off  t1  bytes 
in  single  density  and  22  bytes  in  double  density  from  the 
CRC  field  and  the  Write  Gate  (WG)  output  is  made  active  if 
the  DRQ  is  serviced  (i.e.,  the  DR  has  been  loaded  by  the 
computer).  If  DRQ  has  not  been  serviced,  the  command  is 
terminated  and  the  Lost  Data  status  bit  is  set.  If  the  DRQ 
has  been  serviced,  the  WG  is  made  active  and  six  bytes  of 
zeroes  in  single  density  and  12  bytes  in  double  density  are 
then  written  on  the  disk.  At  this  time  the  Data  Address 
Mark  is  then  written  on  the  disk  as  determined  by  the  ao 
field  of  the  command  as  shown  below: 


an 


Data  Address  Mark  (Bit  0) 


1  Deleted  Data  Maik 

0  Data  Mark 

The  FD179X  then  writes  the  data  field  and  generates  DRQ's 
to  the  computer.  If  the  DRQ  is  not  serviced  in  time  for 
continuous  writing  the  Lost  Data  Status  Bit  is  set  and  a 
byte  of  zeroes  is  written  on  the  disk.  The  command  is  not 
terminated.  After  the  last  data  byte  has  been  written  on  the 
disk,  the  two-byte  CRC  is  computed  internally  and  written 
on  the  disk  followed  by  one  byte  of  logic  ones  in  FM  or  in 
MFM.  The  WG  output  is  then  deactivated.  For  a  2  MHz 
clock  the  I NTRQ  wi  1 1  set  8  to  1 2  jisec  after  the  last  CRC  byte 
is  written.  For  partial  sector  writing,  the  proper  method  is  to 
write  the  data  and  fill  the  balance  with  zeroes.  By  letting  the 
chip  fill  the  zeroes,  errors  may  be  masked  by  the  lost  data 
status  and  improper  CRC  Bytes. 

TYPE  III  COMMANDS 

READ  ADDRESS 

Upon  receipt  of  the  Read  Address  command,  the  head 
is  loaded  and  the  Busy  Status  Bit  is  set.  The  next 
encountered  ID  field  is  then  read  in  from  the  disk,  and 
the  six  data  bytes  of  the  ID  field  are  assembled  and 
transferred  to  the  DR,  and  a  DRQ  is  generated  for  each 
byte.  The  six  bytes  of  the  ID  field  are  shown  below: 
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Although  the  CRC  characters  are  transferred  to  the 
computer,  the  FD179X  checks  for  validity  and  the  CRC 
error  status  bit  is  set  if  there  is  a  CRC  error.  The  Track 
Address  of  the  ID  field  is  written  into  the  sector 
register  so  that  a  comparison  can  be  made  by  the 
user.  At  the  end  of  the  operation  an  interrupt  is 
generated  and  the  Busy  Status  is  reset. 
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READ  TRACK 

Upon  receipt  of  the  READ  track  command,  the  head  is 
loaded,  and  the  Busy  Status  bit  is  set.  Reading  starts  with 
the  leading  edge  of  the  first  encountered  index  pulse  and 
continues  until  the  next  index  pulse.  All  Gap,  Header,  and 
data  bytes  are  assembled  and  transferred  to  the  data 
register  and  DRQ's  are  generated  for  each  byte.  The  ac- 
cumulation of  bytes  is  synchronized  to  each  address  mark 
encountered.  An  interrupt  is  generated  at  the  completion  of 
the  command. 

This  command  has  several  characteristics  which  make  it 
suitable  for  diagnostic  purposes.  They  are:  the  Read  Gate 


is  not  activated  during  the  command;  no  CRC  checking  is 
performed;  gap  information  is  included  in  the  data  stream; 
the  internal  side  compare  is  not  performed;  and  the  ad- 
dress mark  detector  is  on  for  the  duration  of  the  command. 
Because  the  A.M.  detector  is  always  on,  write  splices  or 
noise  may  cause  the  chip  to  look  for  an  A.M.  If  an  address 
mark  does  not  appear  on  schedule  the  Lost  Data  status  flag 
is  set. 

The  ID  A.M.,  ID  field,  ID  CRC  bytes,  DAM,  Data,  and  Data 
CRC  Bytes  for  each  sector  will  be  correct.  The  Gap  Bytes 
may  be  read  incorrectly  during  write-splice  time  because  of 
synchronization. 


set  eusr  BtscT  pro 

L05I  OAT*   SJA'US 
BITS  4  S 


_/  INTRO  A 

T        nesei  busy    J 


G 


SET INI no 
lOST  D*T* 
flE$ET  BU5> 


$ 


'K  MS  IF  CLOCK 


WWTE  FD  F€  OB 
FBFB  CLK  -  C7 
INITIALIZE  CRC 


d 


INTAOAE SET  BUSY 


0 


BYTEO*<t£AOS 
3£To*lALOST 


WflirE  A I     ihlMFM 
WITH  MI55ING  ClOCK 
INITIALISE  CRC 


*£&  _ I  ¥WU  t  CRC 

ChaR$ 


TYPE  III  COMMAND  WRITE  TRACK 


TYPE  III  COMMAND  WRITE  TRACK 
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CONTROL  BYTES  FOR  INITIALIZATION 


DATA  PATTERN 
IN  DR  (HEX) 

FD179X  INTERPRETATION 

FD1 791/3  INTERPRETATION 

IN  FM  (DDEN  =  1) 

IN  MFM  (DDEN  =  0) 

00  thru  F4 

Write  00  thru  F4  with  CLK  =  FF 

Write  00  thru  F4,  in  MFM 

F5 

Not  Allowed 

Write  A1*  in  MFM,  Preset  CRC 

F6 

Not  Allowed 

Write  C2**  in  MFM 

F7 

Generate  2  CRC  bytes 

Generate  2  CRC  bytes 

F8  thru  FB 

Write  F8  thru  FB,  Clk  =  C7,  Preset  CRC 

Write  F8  thru  FB,  in  MFM 

FC 

Write  FC  with  Clk  =  D7 

Write  FC  in  MFM 

FD 

Write  FD  with  Clk  =  FF 

Write  FD  in  MFM 

FE 

Write  FE,  Clk  =  C7,  Preset  CRC 

Write  FE  in  MFM 

FF 

Write  FF  with  Clk  =  FF 

Write  FF  in  MFM 

'Missing  clock  transition  between  bits  4  and  5 


"Missing  clock  transition  between  bits  3  &  4 


WRITE  TRACK  FORMATTING  THE  DISK 

(Refer  to  section  on  Type  III  commands  for  flow  diagrams.) 

Formatting  the  disk  is  a  relatively  simple  task  when 
operating  programmed  I/O  or  when  operating  under  DMA 
with  a  large  amount  ot  memory.  Data  and  gap  information 
must  be  provided  at  the  computer  interface.  Formatting  the 
disk  is  accomplished  by  positioning  the  R/W  head  over  the 
desired  track  number  and  issuing  the  Write  Track  com- 
mand. 

Upon  receipt  of  the  Write  Track  command,  the  head  is 
loaded  and  the  Busy  Status  bit  is  set.  Writing  starts  with 
the  leading  edge  of  the  first  encountered  index  pulse  and 
continues  until  the  next  index  pulse,  at  which  time  the 
interrupt  is  activated.  The  Data  Request  is  activated  im- 
mediately upon  receiving  the  command,  but  writing  will  not 
start  until  after  the  first  byte  has  been  loaded  into  the  Data 
Register.  If  the  DR  has  not  been  loaded  by  the  time  the 
index  pulse  is  encountered  the  operation  is  terminated 
making  the  device  Not  Busy,  the  Lost  Data  Status  Bit  is  set, 
and  the  Interrupt  is  activated.  If  a  byte  is  not  present  in  the 
DR  when  needed,  a  byte  of  zeroes  is  substituted. 

This  sequence  continues  from  one  index  mark  to  the  next 
index  mark.  Normally,  whatever  data  pattern  appears  in  the 
data  register  is  written  on  the  disk  with  a  normal  clock 
pattern.  However,  if  the  FD179X  detects  a  data  pattern  of 
F5  thru  FE  in  the  data  register,  this  is  interpreted  as  data 
address  marks  with  missing  clocks  or  CRC  generation. 

The  CRC  generator  is  initialized  when  any  data  byte  from 
FB  to  FE  is  about  to  be  transferred  from  the  DR  to  the  DSR 
in  FM  or  by  receipt  of  F5  in  MFM.  An  F7  pattern  will 
generate  two  CRC  characters  in  FM  or  MFM.  As  a  con- 
sequence, the  patterns  F5  thru  FE  must  not  appear  in  the 
gaps,  data  fields,  or  ID  fields.  Also,  CRC's  must  be 
generated  by  an  F7  pattern. 

Disks  may  be  formatted  in  IBM  3740  or  System  34  formats 
with  sector  lengths  of  128, 256, 512,  or  1024  bytes. 


TYPE  IV  COMMANDS 

The  Forced  Interrupt  command  is  generally  used  to  ter- 
minate a  multiple  sector  read  or  write  command  or  to  in- 


sure Type  I  status  in  the  status  register.  This  command  can 
be  loaded  into  the  command  register  at  any  time.  If  there  is 
a  current  command  under  execution  (busy  status  bit  set) 
the  command  will  be  terminated  and  the  busy  status  bit 
reset. 

The  lower  four  bits  ot  the  command  determine  the  con- 
ditional interrupt  as  follows: 

'0  =  Not-Ready  to  Ready  Transition 
H  =  Ready  to  Not-Ready  Transition 
•2  =  Every  Index  Pulse 
*3  =  Immediate  Interrupt 

The  conditional  interrupt  is  enabled  when  the  cor- 
responding bit  positions  of  the  command  ('3  -  '0)  are  set  to 
a  1.  Then,  when  the  condition  for  interrupt  is  met,  the  IN- 
TRO, line  will  go  high  signifying  that  the  condition  specified 
has  occurred.  If  '3  -  '0  are  all  set  to  zero  (HEX  DO),  no  in- 
terrupt will  occur  but  any  command  presently  under 
execution  will  be  immediately  terminated.  When  using  the 
immediate  interrupt  condition  ('3  =  1)  an  interrupt  will  be 
immediately  generated  and  the  current  command  ter- 
minated. Reading  the  status  or  writing  to  the  command 
register  will  not  automatically  clear  the  interrupt.  The  HEX 
DO  is  the  only  command  that  will  enable  the  immediate 
interrupt  (HEX  D8)  to  clear  on  a  subsequent  load  command 
register  or  read  status  register  operation.  Follow  a  HEX  D8 
.  with  DO  command. 

Wart  8  micro  sec  (double  density)  or  16  micro  sec  (single 
density  before  issuing  a  new  command  after  issuing  a 
forced  interrupt  (times  double  when  clock  =  1  MHz). 
Loading  a  new  command  sooner  than  this  will  nullify  the 
forced  interrupt. 

Forced  interrupt  stops  any  command  at  the  end  of  an  in- 
ternal micro-instruction  and  generates  INTRQ  when  the 
specified  condition  is  met.  Forced  interrupt  will  wait  until 
ALU  operations  in  progress  are  complete  (CRC 
calculations,  compares,  etc.). 

More  than  one  condition  may  be  set  at  a  time.  If  for 
example,  the  READY  TO  NOT-READY  condition  (H  =  1) 
and  the  Every  Index  Pulse  ('2  =  1)  are  both  set,  the 
resultant  command  would  be  HEX  "DA".  The  "OR"  func- 
tion is  performed  so  that  either  a  READY  TO  NOT-  READY 
or  the  next  Index  Pulse  will  cause  an  interrupt  condition. 


o 
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D 


( 

ENTER 

) 

I 

SET  BUSY 

RESET  STATUS 

BfTS  2. 4.  S 

' 

COPY'S  FLAG 
TOSSOUNE 
(1795/7  ONLY) 


SETHLD 


INTRQ 
RESET  BUSY 


J 


NO 

[^YES 

DELAY  ISMS" 

-^^             HLT=  1             ^V^ 

NO 

■»  TEST-  ♦.  NO  DELAY 
H  TEST- 1  and  CLK- 1  MHZ.  30  MS  DELAY 


0 


9 


READ  TRACK 
SEQUENCE 


INDEX 
PULSE 


YES 


SHIFT  ONE  BIT 
INTOOSfl 


TRANSFER 
OSRTOOR 


SET 
PRO 


TYPE  HI  COMMAND 
Read  Track/Address 


<  SET  INTRO  \ 

RESET  BUSY  J 


SET  LOST 
DATA  err 


IS 


HEAD  ADDRESS 
SEQUENCE 


RESET  BUSY 

SET  INTRO 

SETRNF 


J 


SHIFT  I  BYTE 
INTO  DSR 


TRANSFER 
BYTE  TO  OR 


TRANSFER  TRACK 

NUMBER  TO  SECTOR 

REG1STOR 


SETCRC 
ERROR  BIT 


c 


SET  INTRO 
RESET  BUSY 


J 


TYPE  III  COMMAND 

Read  Track/Address 


STATUS  REGISTER 

Upon  receipt  of  any  command,  except  the  Force  Interrupt 
command,  the  Busy  Status  bit  is  set  and  the  rest  of  the 
status  bits  are  updated  or  cleared  for  the  new  command.  If 
the  Force  Interrupt  Command  is  received  when  there  is  a 
current  command  under  execution,  the  Busy  status  bit  is 
reset,  and  the  rest  of  the  status  bits  are  unchanged.  If  the 
Force  Interrupt  command  is  received  when  there  is  not  a 
current  command  under  execution,  the  Busy  Status  bit  is 
reset  and  the  rest  of  the  status  bits  are  updated  or  cleared. 
In  this  case,  Status  reflects  the  Type  I  commands. 

The  user  has  the  option  of  reading  the  status  register 
through  program  control  or  using  the  DRQ  line  with  DMA  or 
interrupt  methods.  When  the  Data  register  is  read  the  DRQ 
bit  in  the  status  register  and  the  DRQ  line  are  automatically 
reset.  A  write  to  the  Data  register  also  causes  both  DRQ's 
to  reset. 

The  busy  bit  in  the  status  may  be  monitored  with  a  user 
program  to  determine  when  a  command  is  complete,  in 
lieu  of  using  the  INTRQ  line.  When  using  the  INTRQ,  a  busy 
status  check  is  not  recommended  because  a  read  of  the 
status  register  to  determine  the  condition  of  busy  will  reset 
the  INTRQ  line. 


The  format  of  the  Status  Register  is  shown  below: 


a 


(BITS) 

7 

6 

5 

4 

3 

2 

1 

0 

S7 

S6 

S5 

S4 

S3 

S2 

SI 

so 

Status  varies  according  to  the  type  of  command  executed 
as  shown  in  Table  4. 

Because  of  internal  sync  cycles,  certain  time  delays  must 
be  observed  when  operating  under  programmed  I/O.  They 
are:  (times  double  when  clock  =  1  MHz) 


o 


Operation 

Next  Operation 

Delay  Req'd. 
FM        [      MFM 

Write  to 
Command  Reg. 

Read  Busy  Bit 
(Status  Bit  0) 

12/js      !      6jis 

Write  to 
Command  Reg. 

Read  Status 
Bits  1-7 

28f*s      <      14  mS 

Write  Any 
Register 

Read  From  Diff. 
Register 

0         J         0 

IBM  3740  FORMAT  —  128  BYTES/SECTOR 

Shown  below  is  the  IBM  single-density  format  with  128 
bytes/sector.  In  order  to  format  a  diskette,  the  user  must 
issue  the  Write  Track  command,  and  load  the  data  register 
with  the  following  values.  For  every  byte  to  be  written,  there 
is  one  Data  Request. 
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IBM  3740  FORMAT  —  128  BYTES/SECTOR 

Shown  below  is  the  IBM  single-density  format  with  128 
bytes/sector.  In  order  to  format  a  diskette,  the  user  must 
issue  the  Write  Track  command,  and  load  the  data  register 
with  the  following  values.  For  every  byte  to  be  written,  there 
is  one  Data  Request. 


IBM  SYSTEM  34  FORMAT-  256  BYTES/SECTOR 

Shown  below  is  the  IBM  dual-density  format  with  256 
bytes/sector.  In  order  to  format  a  diskette  the  user  must 
issue  the  Write  Track  command  and  load  the  data  register 
with  the  following  values.  For  every  byte  to  be  written,  there 
is  one  data  request. 


NUMBER 

HEX  VALUE  OF 

OF  BYTES 

BYTE  WRITTEN 

40 

FF(orOO)' 

6 

00 

1 

FC  (Index  Mark) 

26 

FF(or00)' 
00 

6 

1 

FE  (ID  Address  Mark) 

1 

Track  Number 

1 

Side  Number  (00  or  01) 

1 

Sector  Number  (1  thru  1A) 

1 

00  (Sector  Length) 

t 

F7  (2  CRC's  written) 

11 

FF(orOO)' 

6 

00 

1 

FB  (Data  Address  Mark) 

128 

Data  (IBM  uses  E5) 

1 

F7  (2  CRC's  written) 

27 

FF(orOO)' 
FF(or00)' 

247** 

'Write  bracketed  field  26  times 
*  'Continue  writing  until  FD179X  interrupts  out. 

Approx.  247  bytes. 
1-Optional  '00'  on  1795/7  only. 


NUMBER 

HEX  VALUE  OF 

OF  BYTES 

BYTE  WRITTEN 

80 

4E 

12 

00 

3 

F6  (Writes  C2) 

1 

FC  (Index  Mark) 

*  50 

4E 
00 

12 

3 

F5  (Writes  A1) 

1 

FE  (ID  Address  Mark) 

1 

Track  N  umber  (0  thru  4Q 

1 

Side  Number (0  or  1) 

1 

Sector  Number(1  thru  1A) 

1 

01  (Sector  Length) 

1 

F7  (2  CRCs  written) 

22 

4E 

12 

00 

3 

F5  (Writes  A1) 

1 

FB  (Data  Address  Mark) 

256 

DATA 

1 

F7  (2  CRCs  written) 

54 

4E 
4E 

598*" 

"Write  bracketed  field  26  times 
'Continue  writing  until  FD179X  interrupts  out. 
Approx.  598  bytes. 


•HYSKAt  HHl 


•""-"I 

jf WK 

K  MKMH*S  MAPH 

■- - 

GIF 
I44MTE5    WU 

linn 

4*»  i 

K1TIMKI 

■H  &Tt«  MM. 

>»Tf<J 

■4  ■ 

io  a** 
ii  airia  (y 

FMU) 
*ttO*0 
taO   ' 

nlm'u 

"0  ) 

a*n 

MCOM 

HO    l 

Uf! 

■0 

HO    J 

C*PI 

C*t*  ^■(^c■ 

SI  - 

IT" 

..., 

„. 

MM  MlCf  MD  ■•  iHfltf  *tT(5  W 
*t  wiiu  dot*  I«*WSITH}H  MlWtlfl 


IBM  TRACK  FORMAT 
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1.  NON-IBM  FORMATS 

Variations  in  the  IBM  formats  are  possible  to  a  limited 
extent  if  the  following  requirements  are  met: 

1 )  Sector  size  must  be  1 28, 256, 51 2  or  1 024  bytes. 

2)  Gap  2  cannot  be  varied  from  the  IBM  format. 

3)  3  bytes  of  A1  must  be  used  in  MFM, 

In  addition,  the  Index  Address  Mark  is  not  required  for 
operation  by  the  FD179X.  Gap  1, 3,  and  4  lengths  can  be  as 
short  as  2  bytes  for  FD179X  operation,  however  PLL  lock  up 
time,  motor  speed  variation,  write-splice  area,  etc.  will  add 
more  bytes  to  each  gap  to  achieve  proper  operation.  It  is 
recommended  that  the  IBM  format  be  used  for  highest 
system  reliability. 


FM 

MFM 

Gap  I 

16  bytes  FF 

32  bytes  4E 

Gap  II 

11  bytes  FF 

22  bytes  4E 

# 

6  bytes  00 

12  bytes  00 
3  bytes  A1 

Gap  HI** 

10  bytes  FF 
4  bytes  00 

24  bytes  4E 
6  bytes  00 
3  bytes  Al 

Gap  IV 

16  bytes  FF 

16  bytes  4E 

'Byte  counts  must  be  exact 
•'Byte  counts  are  minimum,  except  exactly  3  bytes  of  A1 
must  be  written. 


hi  HO     £ 


T£    t    £5  MA»  BEPfRMANEHTiv  f  iCD  L0W  <F  OC54RCO 

■im£  oousles  when  clock    immj 

*  SiftVlCE  1W0HST  CASEi 
■f  M     27  i  uS 
MFM      liiuS 

WO  ttSiMG  ttXit   WDiCATCS  THAI  Th£  d*M  A£flisT€ft  **5  ASSCMfeiED 

D*lA 

WO  FALLING  £004   INDICATES  IhaT  Th£  OaTa  REGISTER  WAS  n£aD 

INTRO  RISING  tOGC  OCCURS  AT  El*  OF  COmmanO 

INTHO  FaliinC  E0OC   INMATES  ThaT  ThE  SIaTuS  NEGATE*  wa$  RfcAC 


READ  ENABLE  TIMING 


TIMING  CHARACTERISTICS 

Ta  =  0°C  to  70°C,  Vdo  =  +  12V  z.   6V,  Vss  =  0V,  Vcc  =+5V  +  .25V 
READ  ENABLE  TIMING   (See  Note  6,  Page  21) 


o 


SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX. 

UNITS 

CONDITIONS 

TSET 

Setup  ADDR  &  CS  to  RE 

50 

nsec 

THLD 

Hold  ADDR  &  CS  from  RE 

10 

nsec 

TRE 

RE  Pulse  Width 

400 

nsec 

Cl  =  50  pf 

TDRR 

DRQ  Reset  from  RE 

400 

500 

nsec 

TIRR 

INTRQ  Reset  from  RE 

500 

3000 

nsec 

See  Note  5 

TDACC 

Data  Access  from  RE 

350 

nsec 

Cl  =  50  pf 

TDOH 

Data  Hold  From  RE 

50 

150 

nsec 

Cl  =  50  pf 

WRITE  ENABLE  TIMING   (See  Note  6,  Page  21) 


SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX. 

UNITS 

CONDITIONS 

TSET 

Setup  ADDR  &  CS  to  WE 

50 

nsec 

THLD 

Hold  ADDR  &  CS  from  WE 

10 

nsec 

TWE 

WE  Pulse  Width 

350 

nsec 

TDRR 

DRQ  Reset  from  WE 

400 

500 

nsec 

TIRR 

INTRQ  Reset  from  WE 

500 

3000 

nsec 

See  Note  5 

TDS 

Data  Setup  to  WE 

250 

nsec 

TDH 

Data  Hold  from  WE 

70 

nsec 
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W 


\ 


1" 

[-*      TOOR                                                                                      1 

,  J 

f 

r 

DHO      < 1 

1 
1 

^m —      TiflR       —         — fc-[ 

i't '  *>f       j            I 



1 

[ 

r* 

THLD 

" 

-O 

1- 

-^ TW(     M* 

SFF     

| „~ 

- 

'SIT 

— 

1 

f     ClATA 

MlfST 
ALIO 

1        SEV 

— \ "» k 

^     1  fpH  1  ^ 

1  SERVICE  tWO«5T 
MFM      tl  i«S 

NOTE    1  C5  MAY  6C  PEflMANENTIV  TIED  LOW  IF  DESIRED 

2  WHEN  WRITING  DaTa  INTO  SECTOR  TRaCk  Ofl  DATA 
REGISTER  USER  CANNOT  READ  THIS  REGISTER  UNTH. 
AT  LEAST  4  „SEC  IN  MFM  AFTER  THE  H*SING  EDGC  OF  WE 
-  .  ce              WHEN  WftiTWG  INFO  THE  COMMAND  REGISTER  STATUS 
-Ait  1             ,s  nqT  vAL,p  UNTIL  SOME  26  mSEC  IN  FM   14  MSEC  m  MFM 
LATER   THESE  TIMES  ARE  DOUBLED  WHEN  CLK        t  MHi 
TIME  DOU6LE5  WHEN  CLOCK        IMHi 

DRO  ASH4G  EDGE    INDICATES  T«AT  THE  PaTA  R€Gi$fEA  1$.  EMPTY 

ORQ  f  ALLIfciS  EOQE    INDICATES  THAI  Th£  OaT*  R£GiST£n  15  LOaMD 

INTRO  RISING  EDGE   inO*CaT£  Th£  END  Of  A  COMMAND 

INTRO    FALLING    C.6GE      INDICATES     THAT    THE     COMMAND    REGISTER 

IS  WRITTEN  TO 

1 

i_r 

'* — H    h- 

u 

■"  1=-. 

-H 

■i —  rt  — 

""i 

" 

NOMINAL 

DISKETTE 

MODE 

CLK 

T. 

T„ 

T, 

DDEN 

8" 
8" 
5" 
5" 

MFM 
FM 

MFM 
FM 

0 
1 
0 
1 

2  MHz 
2  MHz 
1  MHz 
1  MHz 

1  f/S 

2  ps 
2  lis 

4  jiS 

1  ^S 

2iis 
2*iS 
4  (iS 

2  liS 
4  jiS 
4  jiS 
6  *$ 

INPUT  DATA  TIMING 


WRITE  ENABLE  TIMING 
INPUT  DATA  TIMING: 


SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX. 

UNITS 

CONDITIONS 

Tpw 

tbc 

Tc 

Txi 

Tx* 

Raw  Read  Pulse  Width 

100 

1500 

1600 

40 

40 

200 

2000 
2000 

nsec 
nsec 
nsec 
nsec 
nsec 

See  Note  1 
1800  ns@  70°C 
1800  ns  @  70°C 

See  Note  i 
See  Note  1 

Raw  Read  Cycle  Time 
RCLK  Cycle  Time 

RCLK  hold  to  Raw  Read 

Raw  Read  hold  to  RCLK 

WRITE  DATA  TIMING:  (ALL  TIMES  DOUBLE  WHEN  CLK  =  1  MHz) 

(See  Note  6,  Page  21) 

SYMBOL 

CHARACTERISTICS 

MIN. 

TYP. 

MAX. 

UNITS 

CONDITIONS 

Twp 

Write  Data  Pulse  Width 

500 

650 

nsec 

FM 

200 

350 

nsec 

MFM 

Twg 

Write  Gate  to  Write  Data 

2 
1 

Msec 
/Ltsec 

FM 
MFM 

Tbc 

Write  data  cycle  Time 

2,3,  or  4 

fisec 

±  CLK  Error 

T« 

Early  (Late)  to  Write  Data 

125 

nsec 

MFM 

Th 

Early  (Late)  From 
Write  Data 

125 

nsec 

MFM 

Twf 

Write  Gate  off  from  WD 

2 
1 

ftsec 

FM 

MFM 

Twdl 

WD  Valid  to  Clk 

100 
50 

nsec 
nsec 

CLK=1  MHZ 
CLK =2  MHZ 

Twd2 

WD  Valid  after  CLK 

100 
30 

nsec 
nsec 

CLK=1  MHZ 
CLK=2  MHZ 

19 


CLK 

(2MHZ) 


■~L 


1_ 


V/////A  I  V////A 


1 


CLK 
(ZMHZ) 
(DOEN  = 


„~L 


125 *-p« 1»- 


WO   MUST   HAVE   FUSING   EDGE    IN    FIRST   SHADED   AREA    AND   TRAILING 
EDGE  IN  SECOND  SHADED  AREA. 


WRITE  DATA/CLOCK  RELATIONSHIP 


% 


WRITE  DATA  TIMING 


MISCELLANEOUS  TIMING:  (Times  Double  When  Clock  =  1  MHz)     {See  Note  6,  Page  21) 


O 


SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX. 

UNITS 

CONDITIONS 

TCDi 

Clock  Duty  (low) 

230 

250 

20000 

nsec 

TCDs 

Clock  Duty  (high) 

200 

250 

20000 

nsec 

TSTP 

Step  Pulse  Output 

2or4 

Msec 

See  Note  5 

TDIR 

Dir  Setup  to  Step 

12 

Aisec 

±  CLK  ERROR 

TMR 

Master  Reset  Pulse  Width 

50 

Msec 

TIP 

Index  Pulse  Width 

10 

/jisec 

See  Note  5 

TWF 

Write  Fault  Pulse  Width 

10 

Msec 

» 


w 


NOTES: 

1.  Pulse  width  on  RAW  READ  (Pin  27)  is  normally 
100-300  ns.  However,  pulse  may  be  any  width  if 
pulse  is  entirely  within  window.  If  pulse  occurs  in  both 
windows,  then  pulse  width  must  be  less  than  300  ns 
tor  MFM  at  CLK  =  2  MHz  and  600  ns  for  FM  at  2 
MHz.  Times  double  for  1  MHz. 
A  PPL  Data  Separator  is  recommended  for  8"  MFM. 

tbc  should  be  2  fis,  nominal  in  MFM  and  4  p.s  nominal 

in  FM.  Times  double  when  CLK  =  1  MHz. 

RCLK  may  be  high  or  low  during  RAW  READ  (Polarity 

is  unimportant). 

Times  double  when  clock  =  1  MHz. 


2. 
3. 


5. 


Output  timing  readings  are  at  Vol  =  o.8vandVoH  = 
2.0v. 


MISCELLANEOUS  TIMING 

■FROM  STEP  RATE  TABLE 

Table  4.  STATUS  REGISTER  SUMMARY 


ALL  TYPE  1 

READ 

READ 

READ 

WRITE 

WRITE 

BIT 

COMMANDS 

ADDRESS 

SECTOR 

TRACK 

SECTOR 

TRACK 

S7 

NOT  READY 

NOT  READY 

NOT  READY 

NOT  READY 

NOT  READY 

NOT  READY 

S6 

WRITE 
PROTECT 

0 

0 

0 

WRITE 
PROTECT 

WRITE 
PROTECT 

S5 

HEAD  LOADED 

0 

RECORD  TYPE 

0 

WRITE  FAULT 

WRITE  FAULT 

S4 

SEEK  ERROR 

RNF 

RNF 

0 

RNF 

0 

S3 

CRC  ERROR 

CRC  ERROR 

CRC  ERROR 

0 

CRC  ERROR 

0 

S2 

TRACK  0 

LOST  DATA 

LOST  DATA 

LOST  DATA 

LOST  DATA 

LOST  DATA 

S1 

INDEX  PULSE 

DRQ 

DRQ 

DRQ 

DRQ 

DRQ 

SO 

BUSY 

BUSY 

BUSY 

BUSY 

BUSY 

BUSY 

STATUS  FOR  TYPE  I  COMMANDS 


BIT  NAME 

MEANING 

S7  NOT  READY 

This  bit  when  set  indicates  the  drive  is  not  ready.  When  reset  it  indicates  that  the  drive 
is  ready.  This  bit  is  an  inverted  copy  of  the  Ready  input  and  logically  ored'  with  MR. 

S6  PROTECTED 

When  set,  indicates  Write  Protect  is  activated.  This  bit  is  an  inverted  copy  of  WRPT 
input. 

S5  HEAD  LOADED 

When  set,  it  indicates  the  head  is  loaded  and  engaged.  This  bit  is  a  logical  "and"  of 
HLD  and  HLT  signals. 

S4  SEEK  ERROR 

When  set,  the  desired  track  was  not  verified.  This  bit  is  reset  to  0  when  updated. 

S3  CRC  ERROR 

CRC  encountered  in  ID  field. 

S2  TRACK  00 

When  set,  indicates  Read/Write  head  is  positioned  to  Track  0.  This  bit  is  an  inverted 
copy  of  the  TROO  input. 

S1  INDEX 

When  set,  indicates  index  mark  detected  from  drive.  This  bit  is  an  inverted  copy  of  the 
IP  input. 

SO  BUSY 

When  set  command  is  in  progress.  When  reset  no  command  is  in  progress. 
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STATUS  FOR  TYPE  II  AND  III  COMMANDS 

BIT  NAME 

MEANING 

S7  NOT  READY 

This  bit  when  set  indicates  the  drive  is  not  ready.  When  reset,  it  indicates  that  the  drive 
is  ready.  This  bit  is  an  inverted  copy  of  the  Ready  input  and  'ored'  with  MR.  The  Type  II 
and  III  Commands  will  not  execute  unless  the  drive  is  ready. 

S6  WRITE  PROTECT 

On  Read  Record:  Not  Used.  On  Read  Track:  Not  Used.  On  any  Write:  It  indicates  a 
Write  Protect.  This  bit  is  reset  when  updated. 

S5  RECORD  TYPE/ 
WRITE  FAULT 

On  Read  Record:  It  indicates  the  record-type  code  from  data  field  address  mark. 
1  =  Deleted  Data  Mark.  0  =  Data  Mark.  On  any  Write:  It  indicates  a  Write  Fault.  This  bit 
is  reset  when  updated. 

S4  RECORD  NOT 
FOUND  (RNF) 

When  set,  it  indicates  that  the  desired  track,  sector,  or  side  were  not  found.  This  bit  is 
reset  when  updated. 

S3  CRC  ERROR 

If  S4  is  set,  an  error  is  found  in  one  or  more  ID  fields;  otherwise  it  indicates  error  in 
data  field.  This  bit  is  reset  when  updated. 

S2  LOST  DATA 

When  set,  it  indicates  the  computer  did  not  respond  to  DRQ  in  one  byte  time.  This  bit  is 
reset  to  zero  when  updated. 

S1  DATA  REQUEST 

This  bit  is  a  copy  of  the  DRQ  output.  When  set,  it  indicates  the  DR  is  full  on  a  Read 
Operation  or  the  DR  is  empty  on  a  Write  operation.  This  bit  is  reset  to  zero  when  up- 
dated. 

SO  BUSY 

When  set,  command  is  under  execution.  When  reset,  no  command  is  under  execution. 

£^ 


ELECTRICAL  CHARACTERISTICS 

Absolute  Maximum  Ratings 
Vw>  with  repect  to  Vss  (ground):  + 15  to  -  0.3V 
Voltage  to  any  input  with  respect  to  Vss  =  + 15  to  -  0.3V 
Ice  =  60  MA  (35  MA  nominal) 
Ido  =  15  MA  (10  MA  nominal) 


Cin  &  Cout  =  15  pF  max  with  all  pins  grounded  except 

one  under  test. 
Operating  temperature  =  0°Cto70°C 
Storage  temperature  =  -  55°C  to  +  125*C 


OPERATING  CHARACTERISTICS  (DC) 

TA  =  0°C  to  70°C,  Voo  =  +  12V  ±  .6V,Vss  =  OV.Voc  =  +  5V  ±  ,25V 


SYMBOL 

CHARACTERISTIC 

MIN. 

MAX. 

UNITS 

CONDITIONS 

k 

Input  Leakage 

10 

MA 

Vin  =  Vdd** 

lot 

Output  Leakage 

10 

mA 

Vout  =  Voo 

VlH 

Input  High  Voltage 

2.6 

V 

V.L 

Input  Low  Voltage 

0.8 

V 

Voh 

Output  High  Voltage 

2.8 

V 

lo  =  -100mA 

Vol 

Output  Low  Voltage 

0.45 

V 

lo  =  1.6  mA* 

Pd 

Power  Dissipation 

0.6 

w 

o 


•1792  and  1794  <0=  1.0  mA 

"Leakage  conditions  are  for  input  pins  without  internal  pull-up  resistors.  Pins  22, 23, 33,  36,  and  37  have  pull-up  resistors. 
See  Tech  Memo  #115  for  testing  procedures. 
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"  MAX" 


.015 
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100  TYP 
014 
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59S 
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_MAX_^  ^|  J     j-.l. 

Svvvvwvmt 


7,N    -*i  m£  p- 

I   I     r  120  MIN  I 


■OM 
.02' 


".690 


40  LEAD  CERAMIC  "A"  or  "AL" 


40  LEAD  RELPACK  "B"  or  "BL" 


-*■    -»n  max  r 

f*      u»     ^1 


»Hh- 


40  LEAD  CERDIP  "CL" 


40  LEAD  PLASTIC  "P"  or  "PL" 
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The  following  information  represents  updates  to  the 
current  WD1770/72/73  Preliminary  Data  sheet.   These  updates 
are  performance  enhancements. 


1, 
2. 
3. 
4. 


TRE  (Page  19)  Changed  from  MIN  150NS  to  MIN  200NS. 

TAH  {Page  19)  Changed  from  MIN  20NS  to  IONS. 

TWE  (Page  19)  Changed  from  MIN  150NS  to  MIN  200NS. 

H  bit  in  Command  (Page  6  last  paragraph) 
Changed  from:   "If  the  hFlag  is  set  and  motor  on 
line  (Pin  20) " 

Changed  to:     "if  the  hFlag  is  NOT  set  and  motor 
on  line  (Pin  20) " 


WES  TERM  DIGITAL 

CORPORATION 


WD1773  51/4"  Floppy  Disk  Controller/Formatter 


FEATURES 

•  100%  SOFTWARE  COMPATIBILITY  WITH 
WD1793 

•  BUILT-IN  DATA  SEPARATOR 

•  BUILT-IN  WRITE  PRECOMPENSATION 

•  SINGLE  <FM)  AND  DOUBLE  (MFM)  DENSITY 

•  28  PIN  DIP,  SINGLE  +5V  SUPPLY 

•  TTL  COMPATIBLE  INPUTS/OUTPUTS 

•  128,  256,  512  OR  1024  SECTOR  LENGTHS 

•  8-BIT  BI-DIRECTIONAL  HOST  INTERFACE 
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PIN  DESIGNATION 


DESCRIPTION 

The  WD1773  is  an  MOS/LSI  device  which  performs 
the  functions  of  a  5Vi"  Floppy  Disk  Controller/ 
Formatter.  It  is  fully  software  compatible  with 
the  Western  Digital  WDITOSK^  allowing  the 
designer  to  reduce  parts  count  and  board  size  on  an 
existing  WD1793  based  design  without  software 
modifications. 

With  the  exception  of  the  enable  Precomp/Ready 
line,  the  WD1773  is  identical  to  the  WD1770  con- 
troller. This  line  serves  as  both  a  READY  input  from 
the  drive  during  READ/STEP  operations,  and  as  a 
Write  Precompensation  enable  during  Write  opera- 
tions. A  built-in  digital  data  separator  virtually 
eliminates  all  external  components  associated  with 
data  recovery  in  previous  designs. 

The  WD1773  is  implemented  in  NMOS  silicon  gate 
technology  and  is  available  in  a  28  pin,  dual-in-line 
package. 
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PIN  DESCRIPTION 


PIN 
NUMBER 

PIN  NAME 

MNEMONIC 

FUNCTION 

1 
2 

CHIP  SELECT 

eg 

R/W 

A  logic  low  on  this  input  selects  the  chip  and 
enable  Host  communication  with  the  device. 

A    logic    high   on    this    input_  controls   the 
placement  of  data  on  the  D0-D7  lines  from  a 
selected  register,  while  a  logic  low  causes  a 
write  operation  to  a  selected  register. 

READ/WRITE 

3,4 

ADDRESS  0,1 

A0,A1 

These  two  inputs  select  a  register  to  Read/Write 
data: 
CSA1A0        R/W  =  1             R/W  =  0 

0      0      0   Status  Reg        Command  Reg 
0      0       1    Track  Reg          Track  Reg 
0       1       0    Sector  Reg        Sector  Reg 
0       1        1    Data  Reg           Data  Reg 

5-12 
13 

DATA  ACCESS  LINES 
0 THROUGH  7 

DAL0-DAL7 
MR 

Eight  bit  bidirectional  bus  used  for  transfer  of 
data,  control,  or  status.  This  bus  is  enabled  by 
CS  and  R/W.  Each  line  will  drive  one  TTL  load. 

A  logic  low  pulse  on  this  line  resets  the  device 
and  initializes  the  status  register.  Internal  pull- 
up. 

Ground. 

MASTER  RESET 

14 

GROUND 

GND 

15 

POWER  SUPPLY 

vec 

+  5V  ±  5%  power  supply  input. 

16 

STEP 

STEP 

The  Step  output  contains  a  pulse  for  each  step 
of  the  drive's  R/W  head. 

17 

DIRECTION 

DIRC 

The  Direction  output  is  high  when  stepping  in 
towards  the  center  of  the  diskette,  and  low 
when  stepping  out. 

18 
19 

CLOCK 

CLK 
RT3 

This  input  requires  a  free-running  40  to  60% 
duty  cycle  clock  (for  internal  timing)  at  8  MHZ 
±1%. 

This  active  low  input  is  the  raw  data  line 
containing  both  clock  and  data  pulses  from  the 
drive. 

READ  DATA 

20 

ENABLE  PRECOMP/ 
READY  LINE 

ENP/RDY 

Serves  as  a  READY  input  from  the  drive  during 
READ/STEP  operations  and  as  a  Write  Precomp 
enable  during  write  operations. 

21 

WRITE  GATE 

WG 

This  output  is  made  valid  prior  to  writing  on  the 
diskette. 

22 
23 

24 

25 

26 

WRITE  DATA 

WD 
TROO 

IP 

FM  or  MFM  clock  and  data  pulses  are  placed  on 
this  line  to  be  written  on  the  diskette. 

This  active  low  input  informs  the  WD1773  that 
the  drive's  R/W  heads  are  positioned  over  Track 
zero. 

This  active  low  input  informs  the  WD1773  when 
the  physical  index  hole  has  been  encountered 
on  the  diskette. 

This    input    is   sampled   whenever   a   Write 
Command  is  received.  A  logic  low  on  this 
line  will  prevent  any  Write  Command  from 
executing.  Internal  pull-up. 

This  input  pin  selects  either  single  (FM)  or 
double  (MFM)  density.  When  DDEN  =  0,  double 
density  is  selected.  Internal  pull-up. 

TRACK  00 

INDEX  PULSE 

WRITE  PROTECT 

WPRT 

DOUBLE  DENSITY 

DDEN 

ENABLE 

PIN  DESCRIPTION  (CONTINUED) 


PIN 
NUMBER 

PIN  NAME 

MNEMONIC 

FUNCTION 

27 
28 

DATA  REQUEST 
INTERRUPT  REQUEST 

DRQ 
INTRQ 

This  active  high  output  indicates  that  the  Data 
Register  is  full  (on  a  Read)  or  empty  (on  a  Write 
operation). 

This  active  high  output  is  set  at  the  completion 
of  any  command  or  reset  a  read  of  the  Status 
Register. 
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ARCHITECTURE 

The  Floppy  Disk  Formatter  block  diagram  is  il- 
lustrated on  page  4.  The  primary  sections  include 
the  parallel  processor  interface  and  the  Floppy  Disk 
interface. 

Data  SNft  Register  —  This  8-bit  register  assembles 
serial  data  from  the  Read  Data  input  (RD)  during  Read 
operations  and  transfers  serial  data  to  the  Write  Data 
output  during  Write  operations. 

Data  Register  —  This  8-bit  register  is  used  as  a 
holding  register  during  Disk  Read  and  Write  opera- 
tions. In  Disk  Read  operations,  the  assembled  data 
byte  is  transferred  in  parallel  to  the  Data  Register 
from  the  Data  Shift  Register.  In  Disk  Write  operations, 
information  is  transferred  in  parallel  from  the  Data 
Register  to  the  Data  Shift  Register. 

When  executing  the  Seek  command,  the  Data  Regis- 
ter holds  the  address  of  the  desired  Track  position. 


This  register  is  loaded  from  the  DAL  and  gated  onto 
the  DAL  under  processor  control. 

Track  Register  —  This  8-bit  register  holds  the  track 
number  of  the  current  Read/Write  head  position.  It  is 
incremented  by  one  every  time  the  head  is  stepped  in 
and  decremented  by  one  when  the  head  is  stepped 
out  (towards  track  00).  The  contents  of  the  register 
are  compared  with  the  recorded  track  number  in  the 
ID  field  during  disk  Read,  Write,  and  Verify  opera- 
tions. The  Track  Register  can  be  loaded  from  or 
transferred  to  the  DAL.  This  Register  should  not  be 
loaded  when  the  device  is  busy. 

Sector  Register  (SR)  —  This  8-bit  register  holds  the 
address  of  the  desired  sector  position.  The  contents 
of  the  register  are  compared  with  the  recorded  sector 
number  in  the  ID  field  during  disk  Read  or  Write 
operations.  The  Sector  Register  contents  can  be 
loaded  from  or  transferred  to  the  DAL  This  register 
should  not  be  loaded  when  the  device  is  busy. 

Command  Register  (CR)  —  This  8-bit  register  holds 
the  command  presently  being  executed.  This  register 
should  not  be  loaded  when  the  device  is  busy  unless 
the  new  command  is  a  force  interrupt.  The  command 
register  can  be  loaded  from  the  DAL,  but  not  read 
onto  the  DAL 

Status  Register  (STR)  —  This  8-bit  register  holds 
device  Status  information.  The  meaning  of  the  Status 
bits  is  a  function  of  the  type  of  command  previously 
executed.  This  register  can  be  read  onto  the  DAL  but 
not  loaded  from  the  DAL 

CRC  Logic  —  This  logic  is  used  to  check  or  to 

generate  the  16-bit  Cyclic  Redundancy  Check  (CRC). 

The  polynomial  is: 

G(x)  =  x16  +  x12  +  x5  +  1. 

The  CRC  includes  alt  information  starting  with  the 

address  mark  and  up  to  the  CRC  characters.  The 

CRC  register  is  preset  to  ones  prior  to  data  being 

shifted  through  the  circuit. 

Arithmetic/Logic  Unit  (ALU)  —  The  ALU  is  a  serial 
comparator,  incrementer,  and  decrementer  and  is 
used  for  register  modification  and  comparisons  with 
the  disk  recorded  ID  field. 
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Timing  and  Control  —  All  computer  and  Floppy  Disk 
interface  controls  are  generated  through  this  logic. 
The  internal  device  timing  is  generated  from  an  exter- 
nal crystal  clock.  The  WD1773  has  two  different 
modes  of  operation  according  to  the  state  of  DDEN. 
When  DDEN  =  0,  double  density  (MFM)  is  enabled. 
When  DDEN  =  1 ,  single  density  is  enabled. 

AM  Detector  —  The  address  mark  detector  detects 
ID,  data  and  index  address  marks  during  read  and 
write  operations. 

Data  Separator  —  A  digital  data  separator  consisting 
of  a  ring  shift  register  and  data  window  detection 
logic  provides  read  data  and  a  recovery  clock  to  the 
AM  detector. 


PROCESSOR  INTERFACE 

The  interface  to  the  processor  is  accomplished 
through  the  eight  Data  Access  Lines  (DAL)  and 
associated  control  signals.  The  DAL  are  used  to 
transfer  Data,  Status,  and  Control  words  out  of,  or  in- 
to the  WD1773.  The  DAL  are  three  state  buffers  that 
are  enabled  as  output  drivers  when  Chip  Select  (CS) 
and  R/W=  1  are  active  or  act  as  input  receivers  when 
CS  and  R/W  =  0  are  active. 

When  transfer  of  data  with  the  Floppy  Disk  Controller 
is  required  by  the  host  processor,  the  device  address 
is  decoded  and  CS  is  made  low.  The  address  bits  A1 
and  AO,  combined  with  the  signal  R/W  during  a  Read 
operation  or  Write  operation  are  interpreted  as  select- 
ing the  following  registers: 


A1  -  AO       READ  (RAW  =  1)        WRITE  (R/W=Q) 


0  0  Status  Register 

0  1  Track  Register 

1  0  Sector  Register 
1  1  Data  Register 


Command  Register 
Track  Register 
Sector  Register 
Data  Register 


During  Direct  Memory  Access  (DMA)  types  of  data 
transfers  between  the  Data  Register  of  the  WD1773 
and  the  processor,  the  Data  Request  (DRQ)  output 
is  used  in  Data  Transfer  control.  This  signal  also 
appears  as  status  bit  1  during  Read  and  Write 
operations. 

On  Disk  Read  operations  the  Data  Request  is  acti- 
vated (set  high)  when  an  assembled  serial  input  byte 
is  transferred  in  parallel  to  the  Data  Register.  This  bit 
is  cleared  when  the  Data  Register  is  read  by  the  pro- 
cessor. If  the  Data  Register  is  read  after  one  or  more 
characters  are  lost,  by  having  new  data  transferred  in- 
to the  register  prior  to  processor  readout,  the  Lost 
Data  bit  is  set  in  the  Status  Register.  The  Read  opera- 
tions continues  until  the  end  of  sector  is  reached. 

On  Disk  Write  operations  the  Data  Request  is  ac- 
tivated when  the  Data  Register  transfers  its  contents 
to  the  Data  Shift  Register,  and  requires  a  new  data 
byte.  It  is  reset  when  the  Data  Register  is  loaded  with 
new  data  by  the  processor.  If  new  data  is  not  loaded 
at  the  time  the  next  serial  byte  is  required  by  the 
Floppy  Disk,  a  byte  of  zeroes  is  written  on  the 
diskette  and  the  Lost  Data  is  set  in  the  Status 
Register. 

At  the  completion  of  every  command  an  INTRQ  is 
generated.  INTRQ  is  reset  by  either  reading  the 
status  register  or  by  loading  the  command  register 
with  a  new  command.  In  addition,  INTRQ  is  gen- 
erated if  a  Force  Interrupt  command  condition  is  met. 

The  WD1773  has  two  modes  of  operation  according 
to  the  state  DDEN  (Pin  26).  When  DDEN  =  1,  single 
density  is  selected.  In  either  case,  the  CLK  input  (Pin 
18)  is  at  8  MHZ. 

GENERAL  DISK  READ  OPERATIONS 

Sector  lengths  of  128, 256, 512  or  1024  are  obtainable 
in  either  FM  or  MFM  formats.  For  FM,  DDEN  should 
be  placed  to  logical  "1"  For  MFM  formats,  DDEN 
should  be  placed  to  a  logical  "0"  Sector  lengths  are 
determined  at  format  time  by  the  fourth  byte  in  the 
"ID"  field. 


SECTOR  LENGTH  TABLE 


SECTOR  LENGTH 
FIELD  (HPQ 


NUMBER  OF  BYTES 
IN  SECTOR  (DECIMAL) 


00 

01 
02 

03 


128 

256 

512 

1024 


number  of  tracks  as  far  as  the  WD1773  is  concerned 
is  from  0  to  255  tracks. 

GENERAL  DISK  WRITE  OPERATION 

When  writing  is  to  take  place  on  the  diskette  the 
Write  Gate  (WG)  output  is  activated,  allowing  current 
to  flow  into  the  Read/Write  head.  As  a  precaution  to 
erroneous  writing  the  first  data  byte  must  be  loaded 
into  the  Data  Register  in  response  to  a  Data  Request 
from  the  device  before  the  Write  Gate  signal  can  be 
activated. 

Writing  is  inhibited  when  the  Write  Protect  input  is  a 
logic  low,  in  which  case  any  Write  command  is  im- 
mediately terminated,  an  interrupt  is  generated  and 
the  Write  Protect  status  bit  is  set. 

For  Write  operations,  the  WD1773  provides  Write 
Gate  (Pin  21)  to  enable  a  Write  condition,  and  Write 
Data  (Pin  22)  which  consists  of  a  series  of  active  high 
pulses.  These  pulses  contain  both  Clock  and  Data  in- 
formation in  FM  and  MFM.  Write  Data  provides  the 
unique  missing  clock  patterns  for  recording  Address 
Marks. 

If  Precomp  Enable  (ENP)  is  active  when  WG  is 
asserted,  automatic  Write  Precompensation  takes 
place.  The  outgoing  Write  Data  stream  is  delayed  or 
advanced  from  nominal  by  125  nanoseconds  ac- 
cording to  the  following  table: 


m 




PATTERN 

MFM 

FM 

X 

1 

1 

0 

Early 

N/A 

X 

0 

1 

1 

Late 

N/A 

0 

0 

0 

1 

Early 

N/A 

1 

0 

0 

0 

Late 

N/A 

Next  Bit  to  be  sent 
Current  Bit  sending 
Previous  Bits  sent 

Precompensation  is  typically  enabled  on  the  inner- 
most tracks  where  bit  shifts  usually  occur  and  bit 
density  is  at  its  maximun. 


COMMAND  DESCRIPTION 

The  WD1773  will  accept  eleven  commands.  Com- 
mand words  should  only  be  loaded  in  the  Command 
Register  when  the  Busy  status  bit  is  off  (Status  bit  0). 
The  one  exception  is  the  Force  Interrupt  command. 
Whenever  a  command  is  being  executed,  the  Busy 
status  bit  is  set.  When  a  command  is  completed,  an 
interrupt  is  generated  and  the  Busy  status  bit  is  reset. 
The  Status  Register  indicates  whether  the  completed 
command  encountered  an  error  or  was  fault  free.  For 
ease  of  discussion,  commands  are  divided  into  four 
types.  Commands  and  types  are  summarized  in 
Table  1. 


O 


The  number  of  sectors  per  tract  as  far  as  the  WD1773 
is  concerned  can  be  from  1  to  255  sectors.  The 
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TABLE  1.     COMMAND  SUMMARY 


BITS 

TYPE     COMMAND 

7 

6 
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4       3 

2 
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I    Restore 

0 
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0       h 
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rrj 

Seek 
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0 
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1        h 
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TO 

I    Step 
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0 
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T       h 
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rrj 

I    Step-in 

0 

1 

0 

T       h 

V 

n 

1) 

!    Step-out 

0 

1 

1 

T       h 

V 

n 

'0 

II    Read  Sector 
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0 

m       L 

E 
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II    Write  Sector 

0 

1 

m       L 

E 

u 

ao 

Itl    Read  Address 

1 

0 

0       0 

E 

u 

0 

III   Read  Track 

1 

1 

0       0 

E 

u 

0 

Id   Write  Track 

1 

1 

1        0 

E 

u 

0 

IV   Force  Interrupt 

1 

0 

1       l3 

"2 

h 

"0 

FLAG  SUMMARY 
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COMMAND 
TYPE 

BIT 
NO(S) 

DESCRIPTION 

I 

0,1 

r1  r0  =  Stepping  Motor  Rate 
See  Table  3  for  Rate  Summary 

I 

2 

V  =  Track  Number  Verify  Flag 

V  =  0,  No  verify 

V  =  1,  Verify  on  destination  track 

1 

3 

h  =  Don't  Care 

1 

4 

T  =  Track  Update  Flag 

T   =  0,  No  update 

T   =  1,  Update  track  register 

H 

0 

ao  =  Data  Address  Mark 

30=  0,FB(DAM) 

arj=  1,F8  (deleted  DAM) 

If 

1 

C  =  Side  Compare  Flag 

C  =  0,  Disable  side  compare 
C  =  1 ,  Enable  side  compare 

II  &  III 

1 

U  =  Update  SSO 

U  =0,  Update  SSO  toO 
U   =  1,  Update  SSO  to  1 

II  &  til 

2 

E  =  15  MS  Delay 

E  =0,  No  30  MS  delay 
E   =  1,15  MS  delay 

H 

3 

S  =  Side  Compare  Flag 

S  =  0,  Compare  for  side  0 
S  =  1,  Compare  for  side  1 

II 

n 

3 
4 

L  =  Sector  Length  Flag 

LSB's  Sector  Length  in  ID  Field 
00          01          10          11 

L    =0         256         512        1024 

128 

L   =  1         128        256         512 

1024 

m  =  Multiple  Record  Flag 

m  =  0,  Single  record 
m  =  1,  Multiple  records 

IV 

(K3 

'x         =  Interrupt  Condition  Flags 

'0        =  1  Not  Ready  To  Ready  Transition 

h         =  1  Ready  To  Not  Ready  Transition 

'2         =1  Index  Pulse 

'3         =1  Immediate  Interrupt,  Requires  A  Reset 

I3-I1      =0  Terminate  With  No  Interrupt  (INTRQ) 

•NOTE:  See  Type  tV  Command  Description  for  further  information 


TYPE  t  COMMANDS 

The  Type  I  Commands  include  the  Restore,  Seek, 
Step,  Step-in,  and  Step-Out  commands.  Each  of  the 
Type  I  Commands  contains  a  rate  field  (r0  r1),  which 
determines  the  stepping  motor  rate  as  defined  in 
Table  3. 

A  4  us  (MFM)  or  8  *<s  (FM)  pulse  is  provided  as  an 
output  to  the  drive.  For  every  step  pulse  issued,  the 
drive  moves  one  track  location  in  a  direction  deter- 
mined by  the  direction  output.  The  chip  will  step  the 
drive  in  the  same  direction  it  last  stepped  unless  the 
command  changes  the  direction. 

The  Direction  signal  is  active  high  when  stepping  in 
and  low  when  stepping  out.  The  Direction  signal  is 
valid  24  or  48  jjsec  before  the  first  stepping  pulse  is 
generated. 

When  a  Seek,  Step  or  Restore  command  is  executed 
an  optional  verification  of  Read-Write  head  position 
can  be  performed  by  settling  bit  2  (V  =  1)  in  the 
command  word  to  a  logic  1.  The  verification  opera- 
tion begins  at  the  end  of  the  30  msec  settling  time. 
The  track  number  from  the  first  encountered  ID  Field 
is  compared  against  the  contents  of  the  Track  Regis- 
ter. If  the  track  numbers  compare  and  the  ID  Field 
Cyclic  Redundancy  Check  (CRC)  is  correct,  the  verify 
operation  is  complete  and  an  INTRQ  is  generated 
with  no  errors.  If  there  is  a  match  but  not  a  valid  CRC, 
the  CRC  error  status  bit  is  set  (Status  bit  3),  and  the 
next  encountered  ID  field  is  read  from  the  disk  for  the 
verification  operation. 

The  WD1773  must  find  an  ID  field  with  correct  track 
number  and  correct  CRC  within  5  revolutions  of  the 
media;  otherwise  the  seek  error  is  set  and  an  INTRQ 
is  generated.  If  V  =  0,  no  verification  is  performed. 

RESTORE  (SEEK  TRACK  0) 

Upon  receipt  of  this  command  the  Track  00  (TROO) 
input  is  sampled.  If  TROO  is  active  low  indicating  the 
Read-Write  head  is  positioned  over  track  0,  the  Track 
Register  is  loaded  with  zeroes  and  an  interrupt  is  gen- 
erated. If  TROO  is  not  active  low,  stepping  pulses  at  a 
rate  specified  by  the  r1  r0  field  are  issued  until  the 
TROO  input  is  activated.  At  this  time  the  Track 
Register  is  loaded  with  zeroes  and  an  interrupt  is 
generated.  If  the  TROO  input  does  not  go  active  low 
after  255  stepping  pulses,  the  WD1773  terminates 
operation,  interrupts,  and  sets  the  Seek  error  status 
bit,  providing  the  V  flag  is  set.  A  verification  operation 
also  takes  place  if  the  V  flag  is  set  Note  that  the 
Restore  command  is  executed  when  fvTfi  goes  from 
an  active  to  an  inactive  state  and  that  the  DRQ  pin 
stays  low. 

SEEK 

This  command  assumes  that  the  Track  Register 
contains  the  track  number  of  he  current  position  of 
the  Read-Write  head  and  the  Data  Register  contains 
the  desired  track  number.  The  WD1773  will  update 
the  Track  register  and  issue  stepping  pulses  in  the 
appropriate  direction  until  the  contents  of  the  Track 


register  are  equal  to  the  contents  of  the  Data  Reg- 
ister (the  desired  track  location).  A  verification 
operation  takes  place  if  the  V  flag  is  on.  An  interrupt 
is  generated  at  the  completion  of  the  command. 
Note:  When  using  multiple  drives,  the  track  register 
must  be  updated  for  the  drive  selected  before  seeks 
are  issued. 

STEP 

Upon  receipt  of  this  command,  the  WD1773  issues 
one  stepping  pulse  to  the  disk  drive.  The  stepping 
motor  direction  is  the  same  as  in  the  previous  step 
command.  After  a  delay  determined  by  the  r1  no  field, 
a  verification  takes  place  if  the  V  flag  is  on.  If  the  U 
flag  is  on,  the  Track  Register  is  updated.  An  interrupt 
is  generated  at  the  completion  of  the  command. 

STEP-IN 

Upon  receipt  of  this  command,  the  WD1773  issues 
one  stepping  pulse  in  the  direction  towards  track  76. 
if  the  U  flag  is  on,  the  Track  Register  is  incremented 
by  one.  After  a  delay  determined  by  the  rW  field,  a 
verification  takes  place  if  the  V  flag  is  on.  An  interrupt 
is  generated  at  the  completion  of  the  command. 

STEP-OUT 

Upon  receipt  of  this  command,  the  WD1773  issues 
one  stepping  pulse  in  the  direction  towards  track  0.  If 
the  U  flag  is  on,  the  Track  Register  is  decremented  by 
one.  After  a  delay  determined  by  the  r1r0  field,  a 
verification  takes  place  if  the  V  flag  is  on.  An  interrupt 
is  generated  at  the  completion  of  the  command. 

TYPE  II  COMMANDS 

The  Type  II  Commands  are  the  Read  Sector  and  Write 
Sector  commands.  Prior  to  loading  the  Type  II  Com- 
mand into  the  Command  Register,  the  computer 
must  load  the  Sector  Register  with  the  desired  sector 
number.  Upon  receipt  of  the  Type  II  command,  the 
busy  status  Bit  is  set.  The  E  flag  is  still  active  pro- 
viding a  delay  of  1  to  30  msec  for  head  settling  time. 

When  an  ID  field  is  located  on  the  disk,  the  WD1773 
compares  the  Track  Number  on  the  ID  field  with  the 
Track  Register.  If  there  is  not  a  match,  the  next  en- 
countered ID  field  is  read  and  a  comparison  is  again 
made.  If  there  was  a  match,  the  Sector  Number  of  the 
ID  field  is  compared  with  the  Sector  Register.  If  there 
is  not  a  Sector  match,  the  next  encountered  ID  field 
is  read  off  the  disk  and  comparisons  again  made.  If 
the  ID  field  CRC  is  correct,  the  data  field  is  then 
located  and  will  be  either  written  into,  or  read  from 
depending  upon  the  command.  The  WD1773  must 
find  an  ID  field  with  a  Track  number,  Sector  number, 
side  number,  and  CRC  within  five  revolutions  of  the 
disk;  otherwise,  the  Record  not  found  status  bit  is  set 
(Status  bit  3)  and  the  command  is  terminated  with  an 
interrupt. 

Each  of  the  Type  II  Commands  contains  an  (m)  flag 
which  determines  if  multiple  records  (sectors)  are  to 
be  read  or  written,  depending  upon  the  command.  If 
m  =  0,  a  single  sector  is  read  or  written  and  an  inter- 
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TYPE  I  COMMAND  FLOW 

rupt  is  generated  at  the  completion  of  the  command, 
ifm  =  1,  multiple  records  are  read  or  written  with  the 
sector  register  internally  updated  so  that  an  address 
verification  can  occur  on  the  next  record.  The 
WD1773  will  continue  to  read  or  write  multiple 
records  and  update  the  sector  register  in  numerical 
ascending  sequence  until  the  sector  register  ex- 
ceeds the  number  of  sectors  on  the  track  or  until  the 
Force  Interrupt  command  is  loaded  into  the  Com- 
mand Register,  which  terminates  the  command  and 
generates  an  interrupt. 

For  example:  If  the  WD1773  is  instructed  to  read 
sector  27  and  there  are  only  26  on  the  track,  the 
sector  register  exceeds  the  number  available.  The 
WD1773  will  search  for  5  disk  revolutions,  interrupt 
out,  reset  busy,  and  set  the  record  not  found  status 
bit. 

The  Type  II  commands  for  WD1773  contain  side 
compare  flags.  When  C  =  0  (Bit  1)  no  side  compar- 
ison is  made.  When  C  =  1 ,  the  LSB  of  the  side  num- 
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TYPE  I  COMMAND  FLOW 

ber  is  read  off  the  ID  Field  of  the  disk  and  compared 
with  the  contents  of  the  (S)  flag  (Bit  3).  If  the  S  flag 
compares  with  the  side  number  recorded  in  the  ID 
field,  the  WD1773  continues  with  the  ID  search.  If  a 
comparison  is  not  made  within  6  index  pulses,  the 
interrupt  line  is  made  active  and  the  Record-Not- 
Found  status  bit  is  set. 

READ  SECTOR 

Upon  receipt  of  the  Read  Sector  command,  the  Busy 
status  bit  is  set,  and  when  an  ID  field  is  encountered 
that  has  the  correct  track  number,  correct  sector 
number,  correct  side  number,  and  correct  CRC,  the 
data  field  is  presented  to  the  computer.  The  Data 
Address  Mark  of  the  data  field  must  be  found  within 
30  bytes  in  single  density  and  43  bytes  in  double 
density  of  the  last  ID  fietd  CRC  byte;  if  not,  the  ID 
field  is  searched  for  and  verified  again  followed  by 
the  Data  Address  Mark  search.  If  after  5  revolutions 
the  DAM  cannot  be  found,  the  Record  Not  Found 
status  bit  is  set  and  the  operation  is  terminated. 


VERIFY 
SEQUENCE 


SET 

cnc 

ERROR 


INTRQ  RESET  BUSY 


) 


INTRO  RESET  BUSY 
SET  SEEK  ERROR 


0 


NOTE:  IF  TEST: 
IF  TEST: 


0,  THERE  IS  NO  ISMS  DELAY 

1  AND  CLK  =  1  MHl,  THERE  IS  A  30MS  DELAY 


TYPE  I  COMMAND  FLOW 

When  the  first  character  or  byte  of  the  data  field  has 
been  shifted  through  the  DSR,  it  is  transferred  to  the 
DR,  and  DRQ  is  generated.  When  the  next  byte  is  ac- 
cumulated in  the  DSR,  it  is  transferred  to  the  DR  and 
another  DRQ  is  generated.  If  the  Computer  has  not 
read  the  previous  contents  of  the  DR  before  a  new 
character  is  transferred  that  character  is  lost  and  the 
Lost  Data  Status  bit  is  set.  This  sequence  continues 
until  the  complete  dta  field  has  been  inputted  to  the 
computer.  If  there  is  a  CRC  error  at  the  end  of  the 
data  field,  the  CRC  error  status  bit  is  set,  and  the 
command  is  terminated  (even  if  it  is  a  multiple  record 
command). 

At  the  end  of  the  Read  operation,  the  type  of  Data 
Address  Mark  encountered  in  the  data  field  is 
recorded  in  the  Status  Register  (Bit  5)  as  shown 
below: 

STATUS 
BITS 

1  Deleted  Data  Mark 

0  Data  Mark 


WRITE  SECTOR 

Upon  receipt  of  the  Write  Sector  command,  the  Busy 
status  bit  is  set.  When  an  ID  field  is  encountered  that 
has  the  correct  track  number,  correct  sector  number, 
correct  side  number,  and  correct  CRC,  a  DRQ  is  gen- 
erated. The  WD1773  counts  off  11  bytes  in  single 
density  and  22  bytes  in  double  density  from  the  CRC 
field  and  the  Write  Gate  (WG)  output  is  made  active  if 
the  DRQ  is  serviced  (i.e.,  the  DR  has  been  loaded  by 
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TYPE  II  COMMAND  FLOW 

the  computer).  If  DRQ  has  not  been  serviced,  the 
command  is  terminated  and  the  Lost  Data  status  bit 
is  set.  If  the  DRQ  has  been  serviced,  the  WG  is  made 
active  and  six  bytes  of  zeroes  in  single  density  and  12 
bytes  in  double  density  are  then  written  on  the  disk 
At  this  time  the  Data  Address  Mark  is  then  written  on 


<m 


the  disk  as  determined  by  the  ^0  field  of  the 
command  as  shown  below: 


an 


Data  Address  Mark  (Bit  0) 


1  Deleted  Data  Mark 

0  Data  Mark 

The  WD1773  then  writes  the  data  field  and  gener- 
ates DRQ's  to  the  computer.  If  the  DRQ  is  not 
serviced  in  time  for  continuous  writing  the  Lost 
Data  Status  Bit  is  set  and  a  byte  of  zeroes  is 
written  on  the  disk.  The  command  is  not  ter- 
minated. After  the  last  data  byte  has  been  written 
on  the  disk,  the  two-byte  CRC  is  computed 
internally  and  written  on  the  disk  followed  by  one 
byte  of  logic  ones  in  FM  or  in  MFM.  The  WG 
output  is  then  deactivated.  The  INTRQ  will  set  48 
t«sec  (MFM)  or  96  ^sec  (FM)  after  the  last  CRC 
byte  is  written.  For  partial  sector  writing,  the 
proper  method  is  to  write  the  data  and  fill  the 
balance  with  zeroes.  By  letting  the  chip  fill  the 
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zeroes,  errors  may  be  masked  by  the  lost  data 
status  and  improper  CRC  Bytes. 

TYPE  III  COMMANDS 

READ  ADDRESS 

Upon  receipt  of  the  Read  Address  command,  the 
Busy  Status  Bit  is  set.  The  next  encountered  ID 
field  is  then  read  in  from  the  disk,  and  the  six 
data  bytes  of  the  ID  field  are  assembled  and 
transferred  to  the  DR,  and  a  DRQ  is  generated  for 
each  byte.  The  six  bytes  of  the  ID  field  are 
shown  below: 


TRACK 
ADDR 

SIDE 
NUMBER 

SECTOR 
ADDRESS 

SECTOR 
LENGTH 

CRC 
1 

CRC 

2 

1 

2 

3 

4 

5 

6 

READ  SECTOR 
SEQUENCE 


PUT  RECORD  TYPE  IN 
STATUS  RES  BIT  5 


e 


INTRO.  RESET  BUSY 
SET  CRC  ERROR 


♦  1TO 
SECTOR  REQ 


1    4   J      (  INTRO  RESET  BUSY  J 
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TYPE  II  COMMAND  FLOW 
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^ 

DELAY  2  BYTES  OF  GAP 

WRITE  SECT/OH 
SEQUENCE 

* 

SETDFW 

* 

DELAY  (BYTES  OF  GAP 

^^          ^s^  wo 

INTRO  RESET  BUSY 
SET  LOST  OATA 

\ 

1 

) 

(yes 

DELAY  1  BYTE  OF  GAP 

— '  /  wo  X 

TURN  ON  WO  4  WRITE 

e  bytes  of  zeros 

fres 

+ 

DELAY  H  BYTES 

WRITE  DATA  AM 

ACCORDING  TO  AO  FIELD 

OF  WRITE  COMMAND 

V 

♦ 

TURN  ONWGi  WRITE 

-1 

OR  TO  DSR,  SET  DRO 

i 

WRITE  BYTE  TO  DISK 

SET  DATA 

LOST 
WRITE  BYTE 
OF  ZEROS 

"| 

_| 

N°,/ALLeYTes\.«S 

_ 

WRITE  CRC 

V.       WfilTTtH     jS 

♦ 

WRITE  1  BYTE  OF  FF  | 

i 

TURN  OFF  WG 

6 

TYPE  II  COMMAND 

Although  the  CRC  characters  are  transferred  to 
the  computer,  the  WD1773  checks  for  validity  and 
the  CRC  error  status  bit  is  set  if  there  is  a  CRC 
error.  The  Track  Address  of  the  ID  field  is  written 
into  the  sector  register  so  that  a  comparison  can 
be  made  by  the  user.  At  the  end  of  the  operation 
an  interrupt  is  generated  and  the  Busy  Status  is 
reset. 

READ  TRACK 

Upon  receipt  of  the  READ  track  command,  the  Busy 
Status  bit  is  set.  Reading  starts  with  the  leading  edge 
of  the  first  encountered  index  pulse  and  continues 
until  the  next  index  pulse.  All  Gap,  Header,  and  data 
bytes  are  assembled  and  transferred  to  the  data  reg- 
ister and  DRQ's  are  generated  for  each  byte.  The 
accumulation  of  bytes  is  synchronized  to  each  ad- 
dress mark  encountered.  An  interrupt  is  generated  at 
the  completion  of  the  command. 

This  command  has  several  characteristics  which 


make  it  suitable  for  diagnostic  purposes.  They  are: 
the  Read  Gate  is  not  activated  during  the  command; 
no  CRC  checking  is  performed;  gap  information  is 
included  in  the  data  stream;  the  internal  side  com- 
pare is  not  performed;  and  the  address  mark  detector 
is  on  for  the  duration  of  the  command.  Because  the 
A.M.  detector  is  always  on,  write  splices  or  noise  may 
cause  the  chip  to  look  for  an  A.M.  If  an  address  mark 
does  not  appear  on  schedule  the  Lost  Data  status 
flag  is  set. 

The  ID  A.M.,  ID  field,  ID  CRC  bytes,  DAM,  Data,  and 
Data  CRC  Bytes  for  each  sector  will  be  correct.  The 
Gap  Bytes  may  be  read  incorrectly  during  write-splice 
time  because  of  synchronization. 

WRITE  TRACK  FORMATTING  THE  DISK 

(Refer  to  section  on  Type  111  commands  for  flow 
diagrams.) 

Formatting  the  disk  is  a  relatively  simple  task  when 
operating  programmed  I/O  or  when  operating  under 
DMA  with  a  large  amount  of  memory.  Data  and  gap 
information  must  be  provided  at  the  computer  inter- 
face. Formatting  the  disk  is  accomplished  by  posi- 
tioning the  R/W  head  over  the  desired  track  number 
and  issuing  the  Write  Track  command. 

Upon  receipt  of  the  Write  Track  command,  the  Busy 
Status  bit  is  set.  Writing  starts  with  the  leading  edge 
of  the  first  encountered  index  pulse  and  continues 
until  the  next  index  pulse,  at  which  time  the  interrupt 
is  activated.  The  Data  Request  is  activated  immedi- 
ately upon  receiving  the  command,  but  writing  will 
not  start  until  after  the  first  byte  has  been  loaded  into 
the  Data  Register.  If  the  DR  has  not  been  loaded  by 
the  time  the  index  pulse  is  encountered  the  opera- 
tion is  terminated  making  the  device  Not  Busy,  the 
Lost  Data  Status  Bit  is  set,  and  the  Interrupt  is  ac- 
tivated. If  a  byte  is  not  present  in  the  DR  when 
needed,  a  byte  of  zeroes  is  substituted. 

This  sequence  continues  from  one  index  mark  to  the 
next  index  mark.  Normally,  whatever  data  pattern  ap- 
pears in  the  data  register  is  written  on  the  disk  with  a 
normal  clock  pattern.  However,  if  the  WD1773  de- 
tects a  data  pattern  of  F5  thru  FE  in  the  data  register, 
this  is  interpreted  as  data  address  marks  with 
missing  clocks  or  CRC  generation. 

The  CRC  generator  is  initialized  when  any  data  byte 
from  F8  to  FE  is  about  to  be  tranferred  from  the  DR  to 
the  DSR  in  FM  or  by  receipt  of  F5  in  MFM.  An  F7  pat- 
tern will  generate  two  CRC  characters  in  FM  or  MFM. 
As  a  consequence,  the  patterns  F5  thru  FE  must  not 
appear  in  the  gaps,  data  fields,  or  ID  fields.  Also, 
CRC's  must  be  generated  by  an  F7  pattern. 

Disks  may  be  formatted  in  IBM  3740  or  System  34 
formats  with  sector  lengths  of  128,  256,  512,  or  1024 
bytes. 

TYPE  IV  COMMANDS 

The  Forced  Interrupt  command  is  generally  used  to 


% 


O 


<m 
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terminate  a  multiple  sector  read  or  write  command  or 
to  insure  Type  I  status  in  the  status  register.  This 
command  can  be  loaded  into  the  command  register 
at  any  time.  If  there  is  a  current  command  under 
execution  (busy  status  bit  set)  the  command  will  be 
terminated  and  the  busy  status  bit  reset. 

The  lower  four  bits  of  the  command  determine  the 
conditional  interrupt  as  follows: 

•O  =  Not-Ready  to  Ready  Transition 
h  =  Ready  to  Not-Ready  Transition 
'2  =  Every  Index  Pulse 
I3  =  Immediate  Interrupt 


The  conditional  interrupt  is  enabled  when  the  cor- 
responding bit  positions  of  the  command  ('3  -  '0)  are 
set  to  a  1.  Then,  when  the  condition  for  interrupt  is 
met,  the  INTRQ  line  will  go  high  signifying  that  the 
condition  specified  has  occurred.  If  K3  -  '0  are  all  set 
to  zero  (HEX  DO),  no  interrupt  will  occur  but  any 
command  presently  under  execution  will  be  immedi- 
ately terminated.  When  using  the  immediate  interrupt 
condition  (>3  =  1)  an  interrupt  will  be  immediately 
generated  and  the  current  command  terminated. 
Reading  the  status  or  writing  to  the  command 
register  will  not  automatically  clear  the  interrupt.  The 
HEX  DO  is  the  only  command  that  will  enable  the 


—/ 


G 


J        IWTBQ  A 

T       RESET  *USY  J 


WRITE  FO  FE  OR 
FBFB  CLK  *  CI 
INITIALIZE  CRC 


Q 


miH  fleser  ftu&v 


<? 


WRITE 
BYTE  OF  2CROS 
SEI  D*TA  LOST 


WRITE  av  in  MFw 
*•{  WITH  MISSING  CLOCK 
INITIALIZE  CRC 


TYPE  III  COMMAND  WRITE  TRACK 


TYPE  HI  COMMAND  WRITE  TRACK 
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immediate  interrupt  (HEX  D8)  to  clear  on  a  sub- 
sequent load  command  register  or  read  status 
register  operation.  Follow  a  HEX  D8  with  DO  com- 
mand. 

Wait  16  ysec  (double  density)  or  32  ^sec  (single 
density  before  issuing  a  new  command  after  issuing 
a  forced  interrupt.  Loading  a  new  command  sooner 
than  this  will  nullify  the  forced  interrupt. 

Forced  interrupt  stops  any  command  at  the  end  of  an 
internal  micro-instruction  and  generates  INTRQ 
when  the  specified  condition  is  met.  Forced  interrupt 
will  wait  until  ALU  operations  in  progress  are 
complete  (CRC  calculations,  compares,  etc.). 

More  than  one  condition  may  be  set  at  a  time.  If  for 
example,  the  READY  TO  NOT-READY  condition  (h 
=  1)  and  the  Every  Index  Pulse  ('2  =  1)  are  both  set, 
the  resultant  command  would  be  HEX  "DA".  The 
"OR"  function  is  performed  so  that  either  a  READY 
TO  NOT-READY  or  the  next  Index  Pulse  will  cause  an 
interrupt  condition. 

STATUS  REGISTER 

Upon  receipt  of  any  command,  except  the  Force 
Interrupt  command,  the  Busy  Status  bit  is  set  and  the 
rest  of  the  status  bits  are  updated  or  cleared  for  the 
new  command.  If  the  Force  Interrupt  Command  is  re- 
ceived when  there  is  a  current  command  under  exe- 
cution, the  Busy  status  bit  is  reset,  and  the  rest  of  the 
status  bits  are  unchanged.  If  the  Force  Interrupt  com- 
mand is  received  when  there  is  not  a  current  com- 
mand under  execution,  the  Busy  Status  bit  is  reset 
and  the  rest  of  the  status  bits  are  updated  or  cleared. 
In  this  case,  Status  reflects  the  Type  I  commands. 

The  user  has  the  option  of  reading  the  status  register 
through  program  control  or  using  the  DRQ  line  with 
DMA  or  interrupt  methods.  When  the  Data  register  is 
read  the  DRQ  bit  in  the  status  register  and  the  DRQ 
line  are  automatically  reset.  A  write  to  the  Data 
register  also  causes  both  DRQ's  to  reset. 

The  busy  bit  in  the  status  may  be  monitored  with  a 
user  program  to  determine  when  a  command  is  com- 
plete, in  lieu  of  using  the  INTRQ  line.  When  using  the 
INTRQ,  a  busy  status  check  is  not  recommended  be- 
cause a  read  of  the  status  register  to  determine  the 
condition  of  busy  will  reset  the  INTRQ  line. 

The  format  of  the  Status  Register  is  shown  below: 


(BITS) 

7 

6 

5 

4 

3 

2 

1 

0 

S7 

S6 

S5 

S4 

S3 

S2 

S1 

SO 

Because  of  internal  sync  cycles,  certain  time  delays 
must  be  observed  when  operating  under  pro- 
grammed I/O.  They  are:  (times  double  when  clock  = 
1MHz) 


Operation 

Next  Operation 

Delay  Req'd. 
FM           MFM 

Write  to 
Command  Reg. 

Read  Busy  Bit 
(Status  Bit  0) 

48fis     |     24/iS 

i 

i 

Write  to 
Command  Reg. 

Read  Status 
Bits  1-7 

64^s    !     32f*s 
i 

Write 
Register 

Read  Any 
Register 

32  us    J     16  us 

I 

• 


IBM  3740  FORMAT  —  128  BYTES/SECTOR 

Shown  below  is  the  IBM  single-density  format  with 
128  bytes/sector.  In  order  to  format  a  diskette,  the 
user  must  issue  the  Write  Track  command,  and  load 
the  data  register  with  the  following  values.  For  every 
byte  to  be  written,  there  is  one  Data  Request 


NUMBER 

HEX  VALUE  OF 

OF  BYTES 

BYTE  WRITTEN 

40 

FF(orOO)' 

6 

00 

1 

FC  (Index  Mark) 

26 

FF(orOO)' 
00 

6 

1 

FE  (ID  Address  Mark) 

1 

Track  Number 

1 

Side  Number (00  or 01) 

1 

Sector  Number  (1  thru  1A) 

1 

00  (Sector  Length) 

1 

F7  (2  CRC's  written) 

11 

FF(orOO)' 

6 

00 

1 

FB  (Data  Address  Mark) 

128 

Data  (IBM  uses  E5) 

1 

F7  (2  CRC's  written) 

27 

FF(orOO)' 
FF(or00)* 

247" 

c 


Status  varies  according  to  the  type  of  command  exe- 
cuted as  shown  in  Table  4. 


'Write  bracketed  field  26  times 
'*  Continue  writing  until  WD1773  interrupts  out. 
Approx.  247  bytes. 


IBM  SYSTEM  34  FORMAT  —  256  BYTES/SECTOR 

Shown  below  is  the  IBM  dual-density  format  with  256 
bytes/sector,  in  order  to  format  a  diskette  the  user 
must  issue  the  Write  Track  command  and  load  the 
data  register  with  the  following  values.  For  eveiy  byte 
to  be  written,  there  is  one  data  request. 
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c 


ENTER 


SET  BUSY 

RESET  STATUS 

BITS  2,  4,  5 


INTRO 
RESET  BUSY 


) 


DELAY  30  MSEC 


NO 


READ 
ADDRESS 


•If  TEST  ±  i,  NO  DELAY 
If  TEST  ±  1  and  CLK  t  1  MHZ,  30  MS  DELAY 


SHIFT  ONE  BIT 
INTO  DSR 


SET 
DRQ 


TYPE  III  COMMAND 

Read  Track/Address 
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READ  ADDRESS 
SEQUENCE 


NO 


SHIFT  1  BYTE 
INTO  OSR 


TRANSFER 
BYTE  TO  DR 


SET  ORQ 


NO 


TRANSFER  TRACK 

NUMBER  TO  SECTOR 

REGISTER 


SET  CRC 
ERROR  BIT 


TYPE  III  COMMAND 

Read  Track/Address 


NUMBER 

HEX  VALUE  OF 

OF  BYTES 

BYTE  WRITTEN 

80 

4E 

12 

00 

3 

1 

*  50 

F6  (Writes  C2) 
FC  (Index  Mark) 

4E 
00 

12 

3 
1 
1 
1 
1 
1 
1 
22 

F5  (Writes  A1) 
FE  (ID  Address  Mark) 
Track  N  umber  (0  thru  4C) 
Side  Number  (0  or  1) 
Sector  Number  (1  thru  1A) 
01  (Sector  Length) 
F7  (2  CRCs  written) 
4E 

12 

00 

3 

1 

256 

F5  (Writes  A1) 

FB  (Data  Address  Mark) 

DATA 

1 

54 

F7  (2  CRCs  written) 

4E 

4E 

598** 

•Write  bracketed  field  26  times 
'  *  Continue  writing  until  WD1773  interrupts  out. 
Approx.  598  bytes. 


1.  NON-IBM  FORMATS 

Variations  in  the  IBM  formats  are  possible  to  a 
limited  extent  if  the  following  requirements  are  met: 

1)  Sector  size  must  be  128, 256, 512  of  1024  bytes. 

2)  Gap  2  cannot  be  varied  from  the  IBM  format. 

3)  3  bytes  of  A1  must  be  used  in  MFM. 

In  addition,  the  Index  Address  Mark  is  not  required 
for  operation.  Gap  1 , 3,  and  4  lengths  can  be  as  short 
as  2  bytes,  however  PLL  lock  up  time,  motor  speed 
variation,  write-splice  area,  etc.  will  add  more  bytes  to 
each  gap  to  achieve  proper  operation.  It  is  recom- 
mended that  the  IBM  format  be  used  for  highest 
system  reliability. 


FM 

MFM 

Gap  I 

16  bytes  FF 

32  bytes  4E 

Gap  II 

11  bytes  FF 

22  bytes  4E 

* 
* 

6  bytes  00 

12  bytes  00 
3  bytes  A1 

Gap  III** 

10  bytes  FF 
4  bytes  00 

24  bytes  4E 
8  bytes  00 
3  bytes  A1 

Gap  IV 

16  bytes  FF 

16  bytes  4E 

*  Byte  counts  must  be  exact. 
"Byte  counts  are  minimum,  except  exactly  3  bytes 
of  A1  must  be  written. 


# 


o 


<w 


15 


§ 


D 


i 


■fid 

9S 


*3*s 


\ 


*& 


"■IPS 
^"8 


:  Ss5 


£11.11.- 
S!£E 


<ClbE  5 

Do      < 


$3 


...  U' 


m 


n 


J 

s 


ffi  3     3 

I   ™    «s 

is 

■  u! 

1  ,    s; 

u.    i      a£ 


is 


aiuf 

5X1(3 


16 


DC  ELECTRICAL  CHARACTERISTICS 

MAXIMUM  RATINGS 

Storage  Temperature -  55°C  to  +  125*C 

Operating  Temperature 0°C  to  70° C  Ambient 

DC  OPERATING  CHARACTERISTICS 


Maximum  Voltage  to  Any  Input 
with  Respect  to  Vss  •  •  •  • 


(-15  to  -0.3V) 


TA  =  O'C  to  70'C,  Vss  =  0V,  VrjC  =  +5V  ±  .25V 

SYMBOL 

CHARACTERISTIC 

MIN. 

MAX. 

UNITS 

CONDITIONS 

IlL 

Input  Leakage 

10 

pA 

V|N  =  VCC 

•OL 

Output  Leakage 

10 

MA 

VOUT  =  VCC 

V|H 

Input  High  Voltage 

ZO 

V 

V|L 

Input  Low  Voltage 

0.8 

V 

VOH 

Output  High  Voltage 

2.4 

V 

l0  =  -  lOOjiA 

vol 

Output  Low  Voltage 

0.40 

V 

Irj  =  1.6  mA 

pd 

Power  Dissipation 

.75 

w 

RPU 

Internal  Pull-Up 

100 

1700 

MA 

V|N  =  0V 

ice 

Supply  Current 

75(Typ) 

150 

mA 

AC  TIMING  CHARACTERISTICS 

TA  =  O'C  to  70'C,  VSS  =  0V,  VQC  =  +  5V  ±  .25V 


READ  ENABLE  TIMING  —  RE  such  that :  RW  =  1,  CS 

=  0. 

SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX. 

UNITS 

CONDITIONS 

TRE 

RE  Pulse  Width  of  Cs" 

200 

nsec 

CL=50pf 

TDRR 

DRQ  Reset  from  RE 

25 

100 

nsec 

TIRR 

INTRQ  Reset  from  RE 

8000 

nsec 

TDV 

DataValidfromRE 

100 

200 

nsec 

Cl  =  50  pf 

TDOH 

Data  Hold  from  RE 

50 

150 

nsec 

C|_  =  50  pf 

o 


Note:  DRQ  and  INTRQ  reset  are  from  rising  edge  (lagging)  of  RE,  whereas  resets  are  from  failing  edge  (leading) 
of  WE 

WRITE  ENABLE  TIMING  —  WE  such  that :  WW  =  0,  CS  =  0. 


SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX. 

UNITS 

CONDITIONS 

TAS 

Setup  ADDR  to  ^ 

50 

nsec 

TSET 

Setup  R/W  to  CS 

0 

nsec 

TAH 

Hold  ADDR  from  CS 

10 

nsec 

THLD 

Hold  R/V7  from  CS 

0 

nsec 

TWE 

WE  Pulse  Width 

200 

nsec 

TDRW 

DRQ  Reset  from  WE 

100 

200 

nsec 

TIRW 

INTRQ  Reset  from  WE 

8000 

nsec 

TDS 

Data  Setup  to  WE 

150 

nsec 

TDH 

Data  Hold  from  WE 

0 

nsec 

V 
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| 

1 

DALS 
0-7 

X 

VALIO 

< 

<V5     — 

* 

T 

TDS »- 

•m tdh ^ 

— Tre.  TyvE 

*— ■     Tqqh        -^> 

R,/W 

\ 
TsET — »A 

^_ 

/ 

U— THLD 

1 

X 

X 

A0,  A1 

1 

4 ». 

1, 

k— tAh 

X 

X 

1 

1        1 

ORQ 

4 

* TORR » 

DRQ 

h- 

— TORW 

REGISTER  TIMINGS 


CLK 


-v? 


r 


EAHLY  TWP 


AAA 

I  I  I 


-6-1/2  CLKS- 


NOMINAL  TWP 


J£ 


-5-1/2  CLKS- 


A 


LATE  TWP 


-4-1/2  CLKS- 


r 


^ 


\ 
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WRITE  DATA  TIMING: 


SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX. 

UNITS 

CONDITIONS 

7WG 

Write  Gate  to  Write  Data 

4 
2 

usee 

FM 
MFM 

TBC 

Write  Data  Cycle  Time 

4,6,8 

usee 

TWF 

Write  Gate  off  from  WD 

4 
2 

usee 

FM 
MFM 

TWP 

Write  Data  Pulse  Width 

820 

690 

570 

1380 

nsec 
nsec 
nsec 
nsec 

Early  MFM 

Nominal  MFM 

Late  MFM 

FM 

INPUT  DATA  TIMING: 


SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX. 

UNITS 

CONDITIONS 

TPW 
TBC 

Raw  Read  Pulse  Width 
Raw  Read  Cycle  Time 

200 
3000 

3000 

nsec 
nsec 

MISCELLANEOUS  TIMING: 


SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX. 

UNtTS 

CONDITIONS 

TCD-i 

Clock  Duty  (low) 

50 

67 

nsec 

(60/40) 

TCD2 

Clock  Duty  (high) 

50 

67 

nsec 

(40/60) 

TSTP 

Step  Pulse  Output 

4 
8 

usee 

MFM 
FM 

TDIR 

Dir  Setup  to  Step 

24 
48 

fisec 

MFM 
FM 

TMR 

Master  Reset  Pulse  Width 

50 

Msec 

TIP 

Index  Pulse  Width 

20 

jisec 

w  V- 


H — tip- 


-f  VIH 


MR   j- 


VIH 


TMR 


CLK 


-TCDS 


DIRC   XOH- 


STEP  IN 


*J~| 


[♦■TDm-jTsTpL^ JTstpJ^ |^-ToiR-»|  U — TSPT 


STEP 


vol 


J~^^^ 


f- 


n 
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MISCELLANEOUS  TIMING 
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Package  Diagrams 


i 


i 


015  MIN 


± 


1460 
'MAX~ 


T^U- 


015 
MIN 


I    S-ll--^     k 

120  MIN  J 

r*^  mi 


28  LEAD  PLASTIC  "R"  or  "PH" 


28  LEAD  CERDIP  "CH" 
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WESTERN  DIGITAL 

CORPORATION 

WD9216-00/WD9216-01 
Floppy  Disk  Data  Separator  —  FDDS 


FEATURES 

•  PERFORMS  COMPLETE  DATA  SEPARATION 
FUNCTION  FOR  FLOPPY  DISK  DRIVES 

•  SEPARATES  FM  OR  MFM  ENCODED  DATA 
FROM  ANY  MAGNETIC  MEDIA 

•  ELIMINATES  SEVERAL  SSI  AND  MSI  DEVICES 
NORMALLY  USED  FOR  DATA  SEPARATION 

•  NO  CRITICAL  ADJUSTMENTS  REQUIRED 

•  COMPATIBLE  WITH  WESTERN  DIGITAL  179X, 
176X  AND  OTHER  FLOPPY  DISK 
CONTROLLERS 

•  SMALL  8-PIN  DUAL-IN-LINE  PACKAGE 

•  +5  VOLT  ONLY  POWER  SUPPLY 

•  TTL  COMPATIBLE  INPUTS  AND  OUTPUTS 


GENERAL  DESCRIPTION 

The  Floppy  Disk  Data  Separator  provides  a  low  cost 
solution  to  the  problem  of  converting  a  single  stream 
of  pulses  from  a  floppy  disk  drive  into  separate  Clock 
and  Data  inputs  for  a  Floppy  Disk  Controller. 

The  FDDS  consists  primarily  of  a  clock  divider,  a 
long-term  timing  corrector,  a  short-term  timing 
corrector,  and  reclocking  circuitry.  Supplied  in  an  8- 
pin  DuaMn-Line  package  to  save  board  real  estate, 
the  FDDS  operates  on  +  5  volts  only  and  is  TTL  com- 
patible on  all  inputs  and  outputs. 

The  WD9216  is  available  in  two  versions;  the 
WD9216-00,  which  is  intended  for5Vi"  disks  and  the 
WD921601  for  5Va  "  and  8"  disks. 
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PIN  CONFIGURATION 
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FLOPPY  DISK  DATA  SEPARATOR  BLOCK  DIAGRAM 


257 


V 


i 


(0 

ro 
8 

s 


ELECTRICAL  CHARACTERISTICS 

MAXIMUM  RATINGS* 

Operating  Temperature  Range 0°Cto  +70°C 

Storage  Temperature  Range -  55°C  to  125°C 

Positive  Voltage  on  any  Pin, 

with  respect  to  ground - +  8.0V 

Negative  Voltage  on  any  Pin, 

with  respect  to  ground -0.3V 

'Stresses  above  those  listed  may  cause  permanent 
damage  to  the  device.  This  is  a  stress  rating  only 
and  functional  operation  of  the  device  at  these  or  at 
any  other  condition  above  those  indicated  in  the 
operational  sections  of  this  specification  is  not 
implied. 


NOTE  When  powering  this  device  from  laboratory  or 
system  power  supplies,  It  is  important  that  the 
Absolute  Maximum  Ratings  not  be  exceeded  or 
device  failure  can  result.  Some  power  supplies 
exhibit  voltage  spikes  or  "glitches"  on  their  outputs 
when  the  AC  power  is  switched  on  and  off.  In  ad- 
dition, voltage  transients  on  the  AC  power  line  may 
appear  on  the  DC  output.  If  this  possibility  exists  it  is 
suggested  that  a  clamp  circuit  be  used. 
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OPERATING  CHARACTERISTICS (TA  =  0°Cto708C,Vcc  = 

+  5V  + 

5%,  unless  otherwise  noted) 

PARAMETER 

MIN. 

TYP. 

MAX. 

UNITS 

COMMENTS 

D.C.  CHARACTERISTICS 

INPUT  VOLTAGE  LEVELS 

Low  Level  V||_ 

0.8 

V 

High  Level  V)H 

2.0 

V 

OUTPUT  VOLTAGE  LEVELS 

Low  Level  Vol 

0.4 

V 

•OL  =  1.6mA 

High  Level  VoH 

2.4 

V 

(OH  =  -  100)iA 

INPUT  CURRENT 

Leakage  l|i_ 

10 

yA 

0«V|n«Vdd 

INPUT  CAPACITANCE 

All  Inputs 

10 

PF 

POWER  SUPPLY  CURRENT 

IDD 

50 

mA 

A.C.  CHARACTERISTICS 

Symbol 

fCY           REFCLK  Frequency 

0.2 

4.3 

MHz 

WD921&O0 

fCY           REFCLK  Frequency 

0.2 

8.3 

MHz 

WD  921601 

tCKH        REFCLK  High  Time 

so 

2500 

ns 

tcKL         REFCLK  Low  Time 

50 

2500 

ns 

tsDON      REFCLK  to  SEPD  "ON"  Delay 

100 

ns 

tSDOFF    REFCLK  to  SEPD  "OFF"  Delay 

100 

ns 

tSFCK       REFCLK  to  SEPCLK  Delay 

100 

ns 

tDLL         DSKD  Active  Low  Time 

0.1 

100 

MS 

tDLH         DSKD  Active  H  igh  Ti  me 

02 

100 

MS 

REFCLK 


SEPD 


frfCKHH 


-tCY. 


h^CKl*- 


\ 


\ 


(SOON 


A / 


f 


'SPCK 


>* — m 


SEPCLK 


DSKD 


"^ 


-tow- 


7Z 


,C 


Figure  3.    AC  CHARACTERISTICS 
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DESCRIPTION  OF  PIN  FUNCTIONS 

PIN 
NUMBER 

PIN  NAME 

SYMBOL 

FUNCTION 

1 

Disk  Data 

DSKD 

Data  input  signal  direct  from  disk  drive.  Con- 
tains combined  clock  and  data  waveform. 

2 

Separated  Clock 

SEPCLK 

Clock  signal  output  from  the  FDDS  derived 
from  floppy  disk  drive  serial  bit  stream. 

3 

Reference  Clock 

REFCLK 

Reference  clock  input. 

4 

Ground 

GND 

Ground. 

5,6 

7 

Clock  Divisor 

CDO,  CD1 

CDO  and  CD1  control  the  internal  clock  divider 
circuit.  The  internal  clock  is  a  submultiple  of  the 
REFCLK  according  to  the  following  table: 
CD1          CDO            Divisor 
0              0                   1 

0  1                    2 

1  0                     4 
1                 1                     8 

SEPD  is  the  data  output  of  the  FDDS 

Separated  Data 

SEPD 

8 

Power  Supply 

vcc 

+  5  volt  power  supply 

D 
to 
io 


O 


4  MHz  CRYSTAL 
OSCILLATOR 

+  4 

1MHz 

' 

♦ 

FLOPPY 
DISK 
DRIVE 

REFCLK             

SEPD 

DSKD 

WD9216-00,  01 

CDO     CD1    SEPCLK 

REGENERATED  DATA 

_     CLK 

RAW  READ 
WD179X,  176X  or  Equiv. 
FLOPPY  DISK 
CONTROLLER 

RCLK 

DERIVED  CLOCK 

DISK  DATA 

\     \ 

GND    GND 

o 


Figure  1. 

TYPICAL  SYSTEM  CONFIGURATION 

(5V4 "  Drive,  Double  Density) 


OPERATION 

A  reference  clock  (REFCLK)  of  between  2  and  8  MHz 
is  divided  by  the  FDDS  to  provide  an  internal  clock. 
The  division  ratio  is  selected  by  inputs  CDO  and  CD1. 
The  reference  clock  and  division  ratio  should  be 
chosen  per  table  1 . 

The  FDDS  detects  the  leading  edges  of  the  disk  data 
pulses  and  adjusts  the  phase  of  the  internal  clock  to 
provide  the  SEPARATED  CLOCK  output. 


Separate  short  and  long  term  timing  correctors 
assure  accurate  clock  separation. 

The  internal  clock  frequency  is  nominally  16  times 
the  SEPCLK  frequency.  Depending  on  the  internal 
timing  correction,  the  internal  clock  may  be  a 
minimum  of  12  times  to  a  maximum  of  22  times  the 
SEPCLK  frequency. 

The  reference  clock  (REFCLK)  is  divided  to  provide 
the  internal  clock  according  to  pins  CDO  and  CD1. 
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TABLE  1: 
CLOCK  DIVIDER  SELECTION  TABLE 
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ro 
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DRIVE 

(8"or51/«") 

DENSITY 
(DDorSD) 

REFCLK 
MHz 

CD1 

CDO 

REMARKS 

8 
8 
8 

DD 
SD 
SD 

8 
8 
4 

0 
0 
0 

0 

1 

0 

>     Select  either  one 

5V4 
5V4 

DD 
DD 

8 
4 

0 
0 

1 

0 

>     Select  either  one 

5V4 
5V4 
5V4 

SD 
SD 
SD 

8 
4 
2 

1 

0 
0 

0 

1 

0 

>     Select  any  one 

D 


intclk  JTJTJTJTJTJTJTJXTlJTnJTJTJT^^ 


SEPCLK 
SEPD 


T_ 


j.  A 


always  two  internal  clock  cycles 


See  page  725  for  ordering  information. 


Figure  2. 


Information  furnished  by  Western  Digital  Corporation  is  believed  to  be  accurate  and  reliable  However,  no  responsibility  is  assumed  by  Western  Digital 
Corporation  for  its  use.  nor  lor  any  infringements  of  patents  or  other  rights  of  third  parties  which  may  result  from  its  use  No  license  is  granted  by 
implication  or  otherwise  under  any  patent  or  patent  rights  of  Western  Digital  Corporation  Western  Digital  Corporation  reserves  the  right  to  change 
specifications  at  anytime  without  notice 
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WESTERN  DIGITAL 

CORPORATION 

TR1863/TR1865 
Universal  Asynchronous  Receiver/Transmitter  (UART) 
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FEATURES 

•  SINGLE  POWER  SUPPLY  —  +5VDC 

•  D.C.  TO  1  MHZ  (64  KB)  (STANDARD  PART) 
TR1863/5 

•  FULL  DUPLEX  OR  HALF  DUPLEX  OPERATION 

•  AUTOMATIC  INTERNAL  SYNCHRONIZATION 
OF  DATA  AND  CLOCK 

•  AUTOMATIC  START  BIT  GENERATION 

•  EXTERNALLY  SELECTABLE 
Word  Length 

Baud  Rate 

Even/Odd  Parity  (Receiver/Verification  — 

Transmitter/Generation) 

Parity  Inhibit 

One,  One  and  One-Half,  or  Two  Stop  Bit 

Generation  (1 V2  at  5  Bit  Level) 

•  AUTOMATIC  DATA  RECEIVEDnTtANSMITTED 
STATUS  GENERATION 

Transmission  Complete 

Buffer  Register  Transfer  Complete 

Received  Data  Available 

Parity  Error 

Framing  Error 

Overrun  Error 

•  BUFFERED  RECEIVER  AND  TRANSMITTER 
REGISTERS 


THREE-STATE  OUTPUTS 
Receiver  Register  Outputs 
Status  Flags 

TTL  COMPATIBLE 

TR1865  HAS  PULL-UP  RESISTORS  ON  ALL 

INPUTS 


APPLICATIONS 

PERIPHERALS 

TERMINALS 

MINI  COMPUTERS 

FACSIMILE  TRANSMISSION 

MODEMS 

CONCENTRATORS 

ASYNCHRONOUS  DATA  MULTIPLEXERS 

CARD  AND  TAPE  READERS 

PRINTERS 

DATA  SETS 

CONTROLLERS 

KEYBOARD  ENCODERS 

REMOTE  DATA  ACQUISITION  SYSTEMS 

ASYNCHRONOUS  DATA  CASSETTES 
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vccC 

NCC 

vssC 

RRDC 

RR8C 

RR7C 

RRg 

RR5C 

RR4 

RR3C 

RR2C 

™1  C 

PEC 

FEC 

OEC 

SFDC 

RRCC 

DRRC 

DRC 

Rl  C 
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27 
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253 
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23p 
22 
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DTRC 

EPE 
3  WLS1 
3WLS2 

SBS 
PPI 

CRL 
3TR8 
3TR7 
3TR6 
3TR5 

TR4 

TR3 
3TR2 

TRl 
TRO 
TRE 


THRL 
3  THRE 
3  MR 


PIN  CONNECTIONS 
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GENERAL  DESCRIPTION 

The  Universal  Asynchronous  Receiver/Transmitter 
(UART)  is  a  general  purpose,  programmable  or 
hardwired  MOS/LSI  device.  The  UART  is  used  to 
convert  parallel  data  to  a  serial  data  format  on  the 
transmit  side,  and  converts  a  serial  data  format  to 
parallel  data  on  the  receive  side. 
The  serial  format  in  order  of  transmission  and 
reception  is  a  start  bit,  followed  by  five  to  eight  data 
bits,  a  parity  bit  (if  selected)  and  one,  one  and  one- 
half,  or  two  stop  bits. 

Three  types  of  error  conditions  are  available  on  each 
received  character  parity  error,  framing  error  (no  valid 
stop  bit)  and  overrun  error. 


The  transmitter  and  receiver  operate  on  external  16X 
clocks,  where  16  clock  times  are  equal  to  one  bit 
time.  The  receiver  clock  is  also  used  to  sample  in  the 
center  of  the  serial  data  bits  to  allow  for  line 
distortion. 

Both  transmitter  and  receiver  are  double  buffered 
allowing  a  one  character  time  maximum  between  a 
data  read  or  write.  Independent  handshake  lines  for 
receiver  and  transmitter  are  also  included.  All  inputs 
and  outputs  are  TTL  compatible  with  three-state 
outputs  available  on  the  receiver,  and  error  flags  for 
bussing  multiple  devices. 


PIN  DEFINITIONS 


D 


PIN 
NUMBER 

NAME 

SYMBOL 

FUNCTION 

1 
2 
3 
4 

5-12 
13 

14 

POWER  SUPPLY 

NC 

GROUND 

RECEIVER  REGISTER 

DISCONNECT 

RECEIVER  HOLDING 
REGISTER  DATA 

PARITY  ERROR 
FRAMING  ERROR 

vcc 

NC 

VSS 
RRD 

RRfr 
RRl 

PE 
FE 

+  5  volts  supply 

No  Internal  Connection 

Ground  =  OV 

A  high  level  input  voltage,  V|h,  applied  to  this 
line   disconnects   the    RECEIVER    HOLDING 
REGISTER  outputs  from  the  RRi-8  data  outputs 
(pins  5-12). 

The    parallel    contents    of    the    RECEIVER 
HOLDING  REGISTER  appear  on  these  lines  if  a 
low-level  input  voltage,  V||_,  is  applied  to  RRD. 
For  character  formats  of  fewer  than  eight  bits 
received  characters  are  right-justified  with  RR1 
(pin  12)  as  the  least  significant  bit  and  the 
truncated  bits  are  forced  to  a  low  level  output 
voltage,  Vol. 

A  high  level  output  voltage,  Voh.  on  tn's  '<ne 
indicates  that  the  received  parity  differ  from 
that  which  is  programmed  by  the  EVEN  PARITY 
ENABLE  control  line  (pin  39).  This  output  is 
updated  each  time  a  character  is  transferred 
to  the  RECEIVER  HOLDING  REGISTER.   PE 
lines  from  a  number  of  arrays  can  be  bussed 
together  since  an  output  disconnect  capability 
is  provided  by  Status  Flag  Disconnect  line 
(pin  16). 

A  high-level  output  voltage,  Voh,  on  this  line 
indicates  that  the  received  character  has  no 
valid  stop  bit,  i.e.,  the  bit  {if  programmed)  is  not 
a  high  level  voltage.  This  output  is  updated  each 
time  a  character  is  transferred  to  the  Receiver 
Holding  Register,  FE  lines  from  a  number  of 
arrays  can  be  bussed  together  since  an  output 
disconnect  capability  is  provided  by  the  Status 
Flag  Disconnect  line  (pin  16). 
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PIN  DEFINITIONS 


PIN 

NUMBER 

NAME 

SYMBOL 

FUNCTION 

15 

OVERRUN  ERROR 

OE 

A  high-level  output  voltage,  Voh.  on  this  line 
indicates  that  the  Data  Received  Flag  (pin  19) 
was  not  reset  before  the  next  character  was 
transferred  to  the  Receiver  Holding  Register. 
OE  lines  from  a  number  of  arrays  can  be  bussed 
together  since  an  output  disconnect  capability 
is  provided  by  the  Status  Flag  Disconnect  line 
(pin  16). 

16 

STATUS  FLAGS 

SFD 

A  high-level  input  voltage,  V|h,  applied  to  this 

DISCONNECT 

pin  disconnects  the  PE,  FE,  OE,  DR  and  THRE 
allowing  them  to  be  buss  connected. 

17 

RECEIVER  REGISTER 

RRC 

The  receiver  clock  frequency  is  sixteen  (16) 

CLOCK 

times  the  desired  receiver  shift  rate. 

18 

DATA  RECEIVED 

DRR 

A  low-level  input  voltage,  Vil,  applied  to  this 

RESET 

line  resets  the  DR  line. 

19 

DATA  RECEIVED 

DR 

A  high-level  output  voltage,  Voh.  indicates  that 
an  entire  character  has  been   received  and 
transferred     to    the     RECEIVER     HOLDING 
REGISTER. 

20 

RECEIVER  INPUT 

Rl 

Serial  input  data  A  high-level  input  voltage,  V|h. 
must   be   present   when  data  is   not   being 
received. 

21 

MASTER  RESET 

MR 

This  line  is  strobed  to  a  high-level  input  voltage, 
Vm,  to  clear  the  logic.  It  resets  the  TRANS- 
MITTER   and    RECEIVER    HOLDING    REGIS- 
TERS, the  TRANSMITTER  REGISTER,  FE,  OE, 
PE,  DR  and  sets  TRO,  THRE,  and  TRE  to  a 
high-level  output  voltage,  VoH- 

22 

TRANSMITTER 

THRE 

A  high-level  output  voltage,  Voh.  on  this  line 

HOLDING  REGISTER 

indicates  the  TRANSMITTER  HOLDING  REGIS- 

EMPTY 

TER    has    transferred    its    contents    to    the 
TRANSMITTER  REGISTER  and  may  be  loaded 
with  a  new  character. 

23 

TRANSMITTER 

THRL 

A  low-level  input  voltage,  V||_,  applied  to  this 

HOLDING  REGISTER 

line  enters  a  character  into  the  TRANSMITTER 

LOAD 

HOLDING  REGISTER.  A  transition  from  a  low- 
level  input  voltage,  V||_,  to  a  high-level  input 
voltage,  Vm,  transfers  the  character  into  the 
TRANSMITTER  REGISTER  if  it  is  not  in  the 
process    of    transmitting    a   character.    If   a 
character  is  being  transmitted,  the  transfer  is 
delayed  until  its  transmission  is  completed. 
Upon    completion,    the    new    character    is 
automatically  transferred  simultaneously  with 
the  initiation  of  the  serial  transmission  of  the 
new  character. 

24 

TRANSMITTER 

TRE 

A  high-level  output  voltage,  Voh,  on  this  line 

REGISTER  EMPTY 

indicates  that  the  TRANSMITTER  REGISTER 
has  completed  serial  transmission  of  a  full 
character  including  STOP  bit(s).  It  remains  at 
this  level  until  the  start  of  transmission  of  the 
next  character. 
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PIN  DEFINITIONS 
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PIN 
NUMBER 

NAME 

SYMBOL 

FUNCTION 

25 

TRANSMITTER 
REGISTER  OUTPUT 

TRO 

The  contents  of  the  TRANSMITTER  REGISTER 
(START  bit,  DATA  bits,  PARITY  bit,  and  STOP 
bits)  are  serially  shifted  out  on  this  line.  When 
no  data  is  being  transmitted,  this  line  will 
remain  at  a  high-level  output  voltage,  VoH-  Start 
of  transmission  is  defined  as  the  transition  of 
the  START  bit  from  a  high-level  output  voltage 
Vqh,  to  a  low-level  output  voltage  VOL- 

26-33 

TRANSMITTER 
REGISTER  DATA 
INPUTS 

TRi-TRs 

The  character  to  be  transmitted  is  loaded  into 
the  TRANSMITTER  HOLDING  REGISTER  on 
these  lines  with  the  THRL  Strobe.  If  a  character 
of  less  than  8  bits  has  been  selected  (by  WLS-| 
and  WLS2),  the  character  is  right  justified  to  the 
least  significant  bit,  TR-(,  and  the  excess  bits 
are  disregarded.  A  high-level  input  voltage,  Vjh, 
will  cause  a  high-level  output  voltage,  VoH,  to 
be  transmitted. 

34 

CONTROL  REGISTER 
LOAD 

CRL 

A  high-level  input  voltage,  Vm,  on  this  line 
loads    the    CONTROL    REGISTER    with    the 
control  bits  (WLS1,  WLS2,  EPE,  PI,  SBS).  This 
line  may  be  strobed  or  hard  wired  to  a  high-level 
input  voltage,  V|H- 

35 

PARITY  INHIBIT 

PI 

A  high-level  input  voltage,  Vm,  on  this  line 
inhibits  the  parity  generation  and  verification 
circuits  and  will  clamp  the  PE  output  (pin  13)  to 
Vol-  If  Parity  is  inhibited,  the  STOP  bit(s)  will 
immediately  follow  the  last  data  bit  of  trans- 
mission. 

36 

STOP  BIT{S)  SELECT 

SBS 

This  line  selects  the  number  of  STOP  bits  to  be 
transmitted  after  the  parity  bit.  A  high-level 
input  voltage  Vm,  on  this  line  selects  two  STOP 
bits,  and  a  low-level  input  voltage,  V|(_,  selects  a 
single   STOP   bit.   The   TR1863   and   TR1865 
generate  1 V2  stop  bits  when  word  length  is  5 
bits  and  SBS  is  High  Vih- 

37-38 

WORD  LENGTH 
SELECT 

WLS2-WLS1 

These  two  lines  select  the  character  length 
(exclusive  of  parity)  as  follows: 

WLS2             WLS1              Word  Length 

Vil                 V|L                        5  bits 
V|L                 V|H                       6  bits 
V|H                 V|L                        7  bits 
V|H                 V|H                       8  bits 

39 

EVEN  PARITY 
ENABLE 

EPE 

This  line  determines  whether  even  or  odd 
PARITY  is  to  be  generated  by  the  transmitter 
and  checked  by  the  receiver.  A  high-level  input 
voltage,  V|H,  selects  even  PARITY  and  a  low- 
level  input  voltage,  Vil,  selects  odd  PARITY. 

40 

TRANSMITTER 
REGISTER 

TRC 

The  transmitter  clock  frequency  is  sixteen  (16) 
times  the  desired  transmitter  shift  rate. 
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THRE 


TRE 


TRO 


15  CLOCK  TIMES 
AFTER  START  OF 
LAST  STOP  BIT       (1) 


V2  CLOCK 
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CASE  I  IF  THE  POSITIVE  TRANSITION  OF 
THRL  OCCURS  >2S0ns  PRIOR  TO  ANY 
CLOCK  FALLING  EDGE  (CF3  IN 
SAMPLEI  THE  A.  B,  C.  AND  D  SIGNALS 
WILL  BE  GENERATED  AS  SHOWN  IN 
DETAIL  II 
CASE  II  IF  THE  POSITIVE  TRANSITION  OF 
THRL  OCCURS  <250ns  PRIOR  TO  ANY 
CLOCK  FALLING  EDGE  (CF3  IN 
SAMPLE).  THE  B.  C,  AND  D  SIGNALS 
MAY  BE  GENERATED  ON  THE  FOL- 
LOWING CLOCK  TIME  I  E  THE  6.  C. 
AND  0  SIGNALS  AS  SHOWN  IN 
DETAIL  MAY  CHANGE  AS  FOLLOWS 

CF3  TO  CF4 

CF4TOCF5 

CH4TOCR5 


NOTE  IT  IS  ADVISABLE  TO  CONSIDER 
CASE  II  FOR  (CLOCK  >  *  0  MHZ 


DETAIL  I 
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START  (1) 


STOP  START 


Rl 


DATA 


DATA 


STOP 


00 


RR1-RR8  AND  ERROR  FLAGS  PE,  FE,  OE(5) 


I 


DR(19) 


1_ 


DRR(18) 


DETAIL: 
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U 


10       11        12        13        14       15 


RRC 


Rl 
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NOMINAL 


STOP  BIT 
TRANSITION 


rr 


-fr 


r 


NOMINAL  BIT  CENTER 


PE,  FE<3) 


■{h 


X 


-H- 


<5>|     | 


RR1-RR8,  OE(3) 

-H — 


I 


-**■ 


DRR 


■It- 


"ir 


DR<3) 


Hi 


L 


A-*4    (4) 


(1)  SEE  APPLICATION  FLAGS  REPORT  NO.  1  FOR  DESCRIP- 
TION OF  START  BIT  DETECTION 

(2)  THE  DELAY  BETWEEN  DRR  AND  DR  =  td  =  500  NS 

(3)  DR.  ERROR  FLAGS,  AND  DATA  ARE  VALID  AT  THE 
NOMINAL  CENTER  OF  THE  FIRST  STOP  BIT 

(4)  DRR  SHOULD  BE  HIGH  A  MINIMUM  OF  "A"  NS  (ONE- 
HALF  CLOCK  TIME  PLUS  tpd)  PRIOR  TO  THE  RISING 
EDGE  OF  DR 

(5)  DATA  AND  OE  PRECEDES  DR,  PE,  AND  FE  FLAGS  BY 
V2  CLOCK 

(6)  DATA  FLAGS  WILL  REMAIN  SET  UNTIL  A  GOOO  CHARAC- 
TER IS  RECEIVED  OR  MASTER  RESET  IS  APPLIED. 

RECEIVER  TIMING 
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CRL STROBE  / 
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ipw- 


t.OV 
1.8V 


'  thold 


3D 
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en 
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DATA  INPUT  LOAD  CYCLE 


CONTROL  REGISTER  LOAD  CYCLE 


SFD 


RRD 


■*-*pdi*J 


"PE,  FE.OE,  DR,  THRE 


0.8V 


X 


2.0V 


*-'pd0*| 


•OUTPUTS  PE,  FE,  OE,  DR,  THRE  ARE  DIS- 
CONNECTED AT  TRANSITION  OF  SFD 
FROM  0.8V  TO  2.0V. 


STATUS  FLAG  OUTPUT  DELAYS 


•RR1-RR8 


0.8V 


Mpd1-H 

X 


2.0V 

N-^-iv_. 


*-»pd0*j 


•RR^RRa  ARE  DISCONNECTED  AT 
TRANSITION  OF  RRD  FROM  0.8V  TO  2.0V. 
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RESET 
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RATE  16XCLK 

i.  SET  CONTROL  BITS 


© 


LOAD  START  BIT  INTO 
RECEIVER  SHIFT  REGISTER 


SHIFT  AND  LOAD  DATA  BIT 
INTO  RECEIVER  SHIFT  REGISTER 


ENABLE  PE  F/F 

TO  BE  SET 

TOVqh 


ENABLE  PE  F/F 

TO  BE  RESET 

TO  VOL 
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ENABLE  FE  F/F 

TO  BE  SET 

TOVqh 


ENABLE  FE  F/F 

TO  BE  RESET 

TO  VOL 


ENABLE  OE  F/F 

TO  BE  SET 

TOVqh 


enable  oef/f 
to  be  reset 

to  vol 


TRANSFER  DATA  BITS  FROM 

RECEIVER  REGISTER  TO 

RECEIVER  HOLDING  REGISTER 

AND  SET  OE  TO 

PROPER  STATE 


SET  OR.  PE  *  FE  FLAGS  TO  PROPER  STATES 


DB  =   V0H 


operator\ 

ACTION         / 


EXAMINE  OUTPUTS 

1.  STROBE  SFD 

2.  STROBE  RRO 


RESET  DR 

DRR  =  Vql 
DR— V0L 
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RECEIVER  FLOW  CHART 
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RECEIVER  SHIFT  REGISTER 
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ENABLE  FE  F/F 
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TOVqh 
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RESET  DR 
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ABSOLUTE  MAXIMUM  RATINGS 

NOTE:  These  voltages  are  measured  with  respect  to  GND 

Storage  Temperature 

Plastic -  55°C  to  +  125°C 

Ceramic -  65°C  to  +  150°C 

Vcc  Supply  Voltage -  0.3V  to  +  7.0V 

Input  Voltage  at  any  pin -  0.3V  to  +  7.0V 

Operating  Free-Air  Temperature 
Ta  Range 0°Cto70°C 

Lead  Temperature  (Soldering,  10  sec.) 300°C 


ELECTRICAL  CHARACTERISTICS 

(VCC  =  5V±5%,VsS  =  0V) 


SYMBOL 

PARAMETER 

TR1863/5 

OPERATING  CURRENT 

MIN 

MAX 

CONDITIONS 

ice 

Supply  Current 
LOGIC  LEVELS 

35ma 

VCC  =  5.25V 

V|H 

Logic  High 

2.4V 

VlL 

Logic  Low 

OUTPUT  LOGIC  LEVELS 

0.6V 

VCC  =  4.75V 

VOH 

Logic  High 

2.4V 

VCC  =  4.75V,  lOH  =  100Ma 

VOL 

Logic  Low 

0.4V 

VCC  =  5.25V,  IOL=  1.6  ma 

IOC 

Output  Leakage 
(High  Impedance  State) 

±10fia 

VOUT  =  OV,VOUT  =  5V 
SFD  =  RRD  =  V-|H 

IlL 

Low  Level  Input  Current 

100fja 

1.6ma 
1fya 

V)N  =  0.4V  TR  1865  only 
V|N  =  VlL,  TR  1863  only 

ItH 

High  Level  Input  Current 

-1(Va 

V|N  =  V|H,  TR  1863  only 
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SWITCHING  CHARACTERISTICS 
(See  "Switching  Waveforms") 


SYMBOL 

PARAMETER 

MIN 

MAX 

CONDITIONS 

'clock 

Clock  Frequency 

VCC  =  4.75V 

TR1863-00 

DC 

1.0  MHz 

TR1 86302 

DC 

2.5  MHz 

TR1863-04 

DC 

3.5  MHz 

TR186306 

DC 

5.0  MHz 

TR1865O0 

DC 

1.0  MHz 

with  internal  pull-ups  on  all  inputs 

TR186502 

DC 

2.5  MHz 

with  Internal  pull-ups  on  all  inputs 

TR1 86504 

DC 

3.5  MHz 

with  internal  pull-ups  on  all  inputs 

TR186506 

DC 

5.0  MHz 

with  internal  pull-ups  on  all  inputs 

tpw 

Pulse  Widths 

CRL 

THRL 

DRR 

MR 

200  ns 
200  ns 
200  ns 
500  ns 

tc 

Coincidence  Time 

200  ns 

thold 

Hold  Time 

20  ns 

tset 

Set  Time 

OUTPUT  PROPAGATION 

DELAYS 

0 

tpdO 

To  Low  State 

250  ns 

tpdl 

To  High  State 
CAPACITANCE 

250  ns 

C|_  =  20  pf,  plus  one  TTL  load 

Cjn 

Inputs 

20  pf 

f  =  1  MHz,  V|N  =  5V 

Co 

Outputs 

20  pf 

f  =  1  MHz,  V|N  =  5V 

00 

w 


03 

en 


O 


See  page  725  for  ordering  information. 
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Corporator!  tor  its  use.  nor  for  any  inlnngements  of  palenis  or  other  rights  ot  third  parties  which  may  result  from  its  use  No  license  is  granted  by 
implication  or  otherwise  under  any  patent  or  patent  rights  ol  Western  Digital  Corporation  Western  Digital  Corporation  reserves  Ihe  right  to  change 
specifications  at  anyiime  without  notice 
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1/Disk  Organization 


TRSDOS  Version  6  can  be  used  with  5VV  single-sided  floppy  diskettes  and 
with  hard  disk.  Floppy  diskettes  can  be  either  single- or  double-density.  See  the 
charts  below  for  the  number  of  sectors  per  track,  number  of  cylinders,  and  so 
on  for  each  type  of  disk.  (Sectors  and  cylinders  are  numbered  starting  with  0.) 


Single-Density  Floppy  Diskette 


Bytes  Sectors     Sectors     Granules  Tracks  Cylinders 

per           per            per             per              per  per  Total 

Sector  Granule       Track*         Track  Cylinder  Drive           Bytes 

256  


256 


(10) 


(10) 


256 
1,280 
2,560 

2      

1     

2,560 

40 

102,400 

2       1       40 

102,400 

(100K)** 

Double-Density  Floppy  Diskette 


^0 


Bytes  Sectors     Sectors     Granules      Tracks      Cylinders 
per  per  per  per  per  per 

Sector  Granule      Track*         Track        Cylinder        Drive 

256  


Total 
Bytes 

256 

6  1f536 

(18)  3  4,608 

1  4,608 

40  184,320 

256  6  (18)  3  1  40  184,320 

(180K)" 

The  number  of  sectors  per  track  is  not  included  in  the  calculation  because  it 
is  equal  to  the  number  of  sectors  per  granule  times  the  number  of  granules 
per  track.  (5  x  2  =  1 0  for  single  density,  6  x  3  =  18  for  double  density,  and 
16  x  2 = 32  for  hard  disk.) 

"Note  that  this  figure  is  the  total  amount  of  space  in  the  given  format.  Keep  in 
mind  that  an  entire  cylinder  is  used  for  the  directory  and  at  least  one  granule 
is  used  for  the  bootstrap  code.  This  leaves  96.25K  available  for  use  on  a 
single-density  data  disk  and  174K  on  a  double-density  data  disk. 
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5"  5-Meg  Hard  Disk 


Note:  Because  of  continual  advancements  in  hard  disk  technology,  the  number 
of  tracks  and  the  number  of  tracks  per  cylinder  may  change.  Therfore,  any  infor- 
mation that  comes  with  your  hard  disk  drive(s)  supersedes  the  information  in 
the  table  below. 

Bytes      Sectors     Sectors     Granules      Tracks      Cylinders 
per  per  per  per  per  per  Total 

Sector    Granule      Track*        Track       Cylinder       Drive  Bytes 

16         4,096 

(32)  2  8,192 

4  32768 

153  5,013,504 

256  16  (32)  2  4  153  5,013,504 

(4.896K) 

The  number  of  sectors  per  track  is  not  included  in  the  calculation  because  it  is 
equal  to  the  number  of  sectors  per  granule  times  the  number  of  granules  per 
track.  (5x2  =  10  for  single  density,  6x3  =  18  for  double  density,  and 
16  x  2 = 32  for  hard  disk.) 


Disk  Space  Available  to  the  User 


One  granule  on  cylinder  0  of  each  disk  is  reserved  for  the  system.  It  contains 
information  about  where  the  directory  is  located  on  that  disk.  If  the  disk  contains 
an  operating  system,  then  all  of  cylinder  0  is  reserved.  This  area  contains  infor- 
mation used  to  load  TRSDOS  when  you  press  the  reset  button. 

One  complete  cylinder  is  reserved  for  the  directory,  the  granule  allocation  table 
(GAT),  and  the  hash  index  table  (HIT).  (On  single-sided  diskettes,  one  cylinder 
is  the  same  as  one  track.)  The  number  of  this  cylinder  varies,  depending  on  the 
size  and  type  of  disk.  Also,  if  any  portion  of  the  cylinder  normally  used  for  the 
directory  is  flawed,  TRSDOS  uses  another  cylinder  for  the  directory.  You  can 
find  out  where  the  FORMAT  utility  has  placed  the  directory  by  using  the 
Free  :drive  command. 

On  hard  disks,  an  additional  cylinder  (cylinder  1)  is  reserved  for  use  in  case 
your  disk  drive  requires  service.  This  provides  an  area  for  the  technician  to  write 
on  the  disk  without  harming  any  data.  (If  you  bring  your  hard  disk  in  for  service, 
you  should  try  to  back  up  the  contents  of  the  disk  first,  just  to  be  safe.) 


Q 


Unit  of  Allocation 


The  smallest  unit  of  disk  space  that  the  system  can  allocate  to  a  file  is  a  gran- 
ule. A  granule  is  made  up  of  a  set  of  sectors  that  are  adjacent  to  one  another 
on  the  disk.  The  number  of  sectors  in  a  granule  depends  on  the  type  and  size 
of  the  disk.  See  the  charts  on  the  previous  two  pages  for  some  typical  sizes. 
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2/Disk  Files 


Methods  of  File  Allocation 


» 


j0 


Record  Length 


» 


TRSDOS  provides  two  ways  to  allocate  disk  space  for  files:  dynamic  allocation 
and  pre-allocation. 

Dynamic  Allocation 

With  dynamic  allocation,  TRSDOS  allocates  granules  only  at  the  time  of  write. 
For  example,' when  a  file  is  first  opened  for  output,  no  space  is  allocated.  The 
first  allocation  of  space  is  done  at  the  first  write.  Additional  space  is  added  as 
required  by  further  writes. 

With  dynamically  allocated  files,  unused  granules  are  de-allocated  (recovered) 
when  the  file  is  closed. 

Unless  you  execute  the  CREATE  system  command,  TRSDOS  uses  dynamic 
allocation. 

Pre-Allocation 

With  pre-allocation,  the  file  is  allocated  a  specified  number  of  granules  when  it 
is  created.  Pre-allocated  files  can  be  created  only  by  the  system  command 
CREATE.  (See  the  Disk  System  Owner's  Manual  for  more  information  on 
CREATE.) 

TRSDOS  automatically  extends  a  pre-allocated  file  as  needed.  However,  it 
does  not  de-allocate  unused  granules  when  a  pre-allocated  file  is  closed.  To 
reduce  the  size  of  a  pre-allocated  file,  you  must  copy  it  to  a  dynamically  allo- 
cated file.  The  COPY  (CLONE  =  N)  system  command  does  this  automatically. 

Files  that  have  been  pre-allocated  have  a  'C  by  their  names  in  a  directory 
listing. 


TRSDOS  transfers  data  to  and  from  disks  one  sector  at  a  time.  These  sectors 
are  256-byte  blocks,  and  are  also  called  the  system's  "physical"  records. 

You  deal  with  records  that  are  256  bytes  in  length  or  smaller,  depending  on 
what  size  record  you  want  to  work  with.  These  are  known  as  "logical"  records. 

You  set  the  size  of  the  logical  records  in  a  file  when  you  open  the  file  for  the  first 
time.  The  size  is  the  number  of  bytes  to  be  kept  in  each  record.  There  may  be 
from  1  to  256  bytes  per  logical  record. 

The  operating  system  automatically  accumulates  your  logical  records  and 
stores  them  in  physical  records.  Since  physical  records  are  always  256  bytes  in 
length,  there  may  be  one  or  more  logical  records  stored  in  each  physical  record. 
When  the  records  are  read  back  from  disk,  the  system  automatically  returns 
one  logical  record  at  a  time.  These  actions  are  known  as  "blocking"  and  "de- 
blocking," or  "spanning" 

For  example,  if  the  logical  record  length  is  200,  sectors  1  and  2  look  like  this: 
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secfOR 


ONE 


seen 


Since  they  are  completely  handled  by  the  operating  system,  you  do  not  need  to 
concern  yourself  with  physical  records,  sectors,  granules,  tracks,  and  so  on. 
This  is  to  your  benefit,  as  the  number  of  sectors  per  granule  varies  from  disk  to 
disk.  Also,  physical  record  lengths  may  change  in  future  versions  of  TRSDOS, 
but  the  concept  of  logical  records  will  not. 

Note:  All  files  are  fixed-length  record  files  with  TRSDOS  Version  6. 


Record  Processing  Capabilities 


TRSDOS  allows  both  direct  and  sequential  file  access. 

Direct  access  (sometimes  called  "random  access")  lets  you  process  records  in 
any  sequence  you  specify. 

Sequential  access  allows  you  to  process  records  in  sequence:  record  n,  n  + 1, 
n +2,  and  so  on.  With  sequential  access,  you  do  not  specify  a  record  number. 
Instead,  TRSDOS  accesses  the  record  that  follows  the  last  record  processed, 
starting  with  record  0. 

With  sequential  access  files,  use  the  @READ  supervisor  call  to  read  the  next 
record,  and  the  ©WRITE  or  @VER  supervisor  call  to  write  the  next  record. 
(When  the  file  is  first  opened,  processing  starts  at  record  0.  You  can  use 
@PEOF  to  position  to  the  end  of  file.) 

To  read  orwrite  to  a  direct  access  file,  use  the  @POSN  supervisor  call  to  posi- 
tion to  a  specified  record.  Then  use  ©READ,  ©WRITE,  or  @VER  as  desired. 
Once  @POSN  has  been  used,  the  End  of  File  (EOF)  marker  will  not  move, 
unless  the  file  is  extended  by  writing  past  the  current  EOF  position. 

Record  Numbers 

Using  direct  (random)  access,  you  can  access  up  to  65,536  records.  Record 
numbers  start  at  0  and  go  to  65535. 

Using  a  file  sequentially,  you  can  access  up  to  16,777,216  bytes,  lb  calculate 
the  number  of  records  you  can  access  sequentially,  use  the  formula: 

16,777,216  -s-  logical  record  length  =  number  of  sequential 

records  allowed 
Below  are  some  examples. 

If  the  LRL  =  256,  then: 

16,777,216  ■*■  256=65,536  records 

If  the  LRL=  128,  then: 

1 6,777,21 6  +  1 28  =  1 31 ,072  records 

lfthel_RL=  50,  then: 

1 6,777,21 6  +    50 = 335,544  records 

lfthel_RL=     1,then: 

1 6,777,21 6  +      1  =  1 6,777,21 6  records 
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3/TRSDOS  File  Descriptions 


This  section  describes  four  types  of  files  found  on  your  TRSDOS  master  disk- 
ette (system  files,  utilities,  driver  programs,  and  filter  programs)  and  explains 
their  functions.  It  also  describes  how  to  construct  a  minimum  system  disk  for 
running  applications  packages. 


System  Files  (/SYS) 


TRSDOS  Version  6  would  occupy  considerable  memory  space  if  all  of  it  were 
resident  in  memory  at  any  one  time.  To  minimize  the  amount  of  memory 
reserved  for  system  use,  TRSDOS  uses  overlays. 

Using  an  overlay-driven  system  involves  some  compromise.  While  a  user's 
application  is  in  progress,  different  overlays  may  need  to  be  loaded  to  perform 
certain  activities  requested  of  the  system.  This  could  cause  the  system  to  run 
slightly  slower  than  a  system  which  has  more  of  its  file  access  routines  always 
resident  in  memory. 

The  use  of  overlays  also  requires  that  a  SYSTEM  disk  usually  be  available  in 
Drive  0  (the  system  drive).  Since  the  disk  containing  the  operating  system  and 
its  utilities  feaves  little  space  available  to  the  user,  you  may  want  to  remove  cer- 
tain parts  of  the  system  software  not  needed  while  a  particular  application  is 
running.  You  may  in  fact  discover  that  your  day-to-day  operations  need  only  a 
minimal  TRSDOS  configuration.  The  greater  the  number  of  system  functions 
unnecessary  for  your  application,  the  more  space  you  can  have  available  for  a 
"working"  system  disk.  Use  the  PURGE  or  REMOVE  library  command  to  elim- 
inate unneeded  system  files  from  the  disk. 

The  following  paragraphs  describe  the  functions  performed  by  each  system 
overlay.  (In  the  display  produced  by  the  DIR  (SYS)  library  command,  the  system 
overlays  are  identified  by  the  file  extension  /SYS.) 

Note:  Two  system  files  are  put  on  the  disk  during  formatting.  They  are  Df  R/SYS 
and  BOOT/SYS.  These  files  should  never  be  copied  from  one  disk  to  another 
or  REMOVEd.  TRSDOS  automatically  updates  any  information  necessary 
when  performing  a  backup. 

SYSO/SYS 

This  is  not  an  overlay.  It  contains  the  resident  part  of  the  operating  system 
(SYS RES).  It  is  also  needed  to  dynamically  allocate  file  space  used  when  writ- 
ing files.  Any  disk  used  for  booting  the  system  must  contain  SYSO.  It  can  be 
purged  from  disks  not  used  for  booting. 

SYS1/SYS 

This  overlay  contains  the  TRSDOS  command  interpreter  and  the  routines  for 
processing  the  @CMNDI,  @CMNDR,  @FEXT,  @FSPEC,  and  @PARAM  sys- 
tem vectors.  This  overlay  must  be  available  on  all  SYSTEM  disks. 

SYS2/SYS 

This  overlay  is  used  for  opening  or  initializing  disk  files  and  logical  devices.  It 
also  contains  routines  for  processing  the  @CKDRV,  @GTDCB,  and  @  REN  AM 
system  vectors,  and  routines  for  hashing  file  specifications  and  passwords. 
This  overlay  must  be  available  on  all  SYSTEM  disks. 

SYS3/SYS 

This  overlay  contains  all  of  the  system  routines  needed  to  close  files  and  logical 
devices.  It  also  contains  the  routines  needed  to  service  the  @FNAME  system 
vector.  This  overlay  must  not  be  removed  from  the  disk. 
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SYS4/SYS 

This  overlay  contains  the  system  error  dictionary.  It  is  needed  to  issue  such 
messages  as  "File  not  found,"  "Directory  read  error,"  etc.  If  you  decide  to 
remove  this  overlay  from  your  working  SYSTEM  disk,  all  system  errors  will  pro- 
duce the  error  message  "SYS  ERROR"  It  is  recommended  that  you  not  remove 
this  overlay,  especially  since  it  occupies  only  one  granule  of  space. 

SYS5/SYS 

This  is  the  "ghost"  debugger.  It  is  needed  if  you  intend  to  test  out  machine  lan- 
guage application  software  by  using  the  TRSDOS  DEBUG  library  command.  If 
your  operation  will  not  require  this  debugging  tool,  you  may  purge  this  overlay. 

SYS6/SYS 

This  overlay  contains  all  of  the  routines  necessary  to  service  the  library  com- 
mands identified  as  "Library  A"  by  the  LIB  command.  This  represents  the  pri- 
mary library  functions.  Only  very  limited  use  can  be  made  of  TRSDOS  if  this 
overlay  is  removed  from  your  working  SYSTEM  disk. 

SYS7/SYS 

This  overlay  contains  all  of  the  routines  necessary  to  service  the  library  com- 
mands identified  as  "Library  B"  by  the  LIB  command.  A  great  deal  of  use  can 
be  made  of  TRSDOS  even  without  this  overlay.  It  performs  specialized  func- 
tions that  may  not  be  needed  in  the  operation  of  specific  applications.  You  can 
purge  this  overlay  if  you  decide  it  is  not  needed  on  a  working  SYSTEM  disk. 

SYS8/SYS 

This  overlay  contains  all  of  the  routines  necessary  to  service  the  library  com- 
mands identified  as  "Library  C"  by  the  LIB  command.  A  great  deal  of  use  can 
be  made  of  TRSDOS  even  without  this  overlay.  It  performs  specialized  func- 
tions that  may  not  be  needed  in  the  operation  of  specific  applications.  You  can 
purge  this  overlay  if  you  decide  it  is  not  needed  on  a  working  SYSTEM  disk. 

SYS9/SYS 

This  overlay  contains  the  routines  necessary  to  service  the  extended  DEBUG 
commands  available  after  a  DEBUG  (EXT)  is  performed.  This  overlay  may  be 
purged  if  you  will  not  need  the  extended  DEBUG  commands  while  running  your 
application.  If  you  remove  SYS5/SYS,  then  you  may  as  well  remove  SYS9/SYS, 
as  it  would  serve  no  useful  purpose. 

SYS10/SYS 

This  system  overlay  contains  the  procedures  necessary  to  service  the  request 
to  remove  a  file.  It  should  remain  on  your  working  SYSTEM  disks. 

SYS11/SYS 

This  overlay  contains  all  of  the  procedures  necessary  to  perform  the  Job  Con- 
trol Language  execution  phase.  You  may  remove  this  overlay  from  your  working 
disks  if  you  do  not  intend  to  execute  any  JCL  functions.  If  SYS6/SYS  (which 
contains  the  DO  command)  has  been  removed,  keeping  this  overlay  would 
serve  no  purpose. 

SYS12/SYS 

This  system  overlay  contains  the  routines  that  service  the  @DODIR, 
@GTMOD,  and  @RAMDIR  system  vectors.  It  should  remain  on  your  disks. 

SYS13/SYS 

This  overlay  is  reserved  for  future  system  use.  It  contains  no  code  and  takes  up 
no  space  on  the  disk.  You  may  remove  this  overlay  if  you  wish  to  free  up  its 
directory  slot. 
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•  SYS2  must  be  on  the  system  disk  if  a  configuration  file  is  to  be  loaded. 

•  SYS11  must  be  present  only  if  any  JCL  files  will  be  used. 

•  All  three  libraries  (SYS  files  6, 7,  and  8)  may  be  purged  if  no  library  com- 
mand will  be  used. 

•  SYS5  and  SYS9  may  be  purged  if  the  system  DEBUG  package  is  not 
needed. 

•  SYSO  may  be  removed  from  any  disk  not  used  for  booting. 

•  SYS11  (the  JCL  processor)  and  SYS6  (containing  the  DO  library  com- 
mand) must  both  be  on  the  disk  if  the  DO  command  is  to  be  used.  Also, 
if  you  remove  SYS6,  you  may  as  well  remove  SYS11. 

•  SYS13  may  be  removed  if  you  have  not  implemented  an  EG,  an  IEP  file, 
or  if  you  do  not  intend  to  use  them. 

The  presence  of  any  utility,  driver,  or  filter  program  is  dependent  upon  your  in- 
dividual needs.  You  can  save  most  of  the  TRSDOS  features  in  a  configuration 
file  using  the  SYSTEM  (SYSGEN)  command,  so  the  driver  and  filter  programs 
will  not  be  needed  in  run  time  applications.  If  you  intend  to  use  the  HELP  utility, 
your  disk  must  contain  the  DOS/HLP  file. 

The  owner  (update)  passwords  for  TRSDOS  files  are  as  follows: 

File  Type 


System  files 
Filter  files 
Driver  files 
Utility  files 
BASIC 

BASIC  overlays 
CONFIG/SYS 
Drive  Code  Table 
Initializer 


Extension 

Owner  Password 

(/SYS) 

LSIDOS 

(/FLT) 

FILTER 

(/DVR) 

DRIVER 

(/CMD) 

UTILITY 

BASIC 

(/OV$) 

BASIC 

CCC 

(/DCT) 

UTILITY 
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4/Device  Access 


Device  Control  Block  (DCB) 


The  Device  Control  Block  (DCB)  is  an  area  of  memory  that  contains  informa- 
tion used  to  interface  the  operating  system  with  various  logical  devices.  These 
devices  include  the  keyboard  (*KI),  the  video  display  (*DO),  a  printer  (*PR),  a 
communications  line  (*CL),  and  other  devices  that  you  may  define. 

The  following  information  describes  each  assigned  DCB  byte. 

DCB +0  (TYPE  Byte) 

Bit  7— If  set  to  "1,"  the  Device  Control  Block  is  actually  a  File  Control  Block 
(FCB)  with  the  file  open.  Since  DCBs  and  FCBs  are  similar,  and 
devices  may  be  routed  to  files,  a  "device"  with  this  bit  set  indicates 
a  routing  to  a  file. 

Bit  6 — If  set  to  "1,"  the  device  defined  by  the  DCB  is  filtered  or  is  a  device 
filter. 

Bit  5— If  set  to  "1,"  the  device  defined  by  the  DCB  is  linked. 

Bit  4— If  set  to  "1,"  the  device  defined  by  the  DCB  is  routed. 

Bit  3 — If  set  to  "1,"  the  device  defined  by  the  DCB  is  a  NIL  device.  Any  out- 
put directed  to  the  device  is  discarded.  For  any  input  request,  the 
character  returned  is  a  null  (ASCII  value  0). 

Bit  2 — If  set  to  "1,"  the  device  defined  by  the  DCB  can  handle  requests 
generated  by  the  @CTL  supervisor  call.  See  the  section  on  Super- 
visor Calls  for  more  information. 

Bit  1  —  If  set  to  "1,"  the  device  defined  by  the  DCB  can  handle  output 
requests  which  normally  come  from  the  @PUT  supervisor  call. 

Bit  0 — If  set  to  "1,"  the  device  defined  by  the  DCB  can  handle  requests  for 
input  which  normally  come  from  the  @GET  supervisor  call. 

DCB + land  DCB +2 

Contain  the  address  of  the  driver  routine  that  supports  the  hardware  assigned 
to  this  DCB.  (In  the  case  of  a  routed  or  linked  device,  the  vector  may  point  to 
another  DCB.) 

DCB + 3  through  DCB  -I-  5 

Reserved  for  system  use. 

DCB+6andDCB+7 

These  locations  normally  contain  the  two  alphabetic  characters  of  the  devspec. 
The  system  uses  the  devspec  as  a  reference  in  searching  the  device  control 
block  tables. 
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Memory  Header 


Modules  that  TRSDOS  loads  into  memory  (filters,  drivers,  and  other  memory 
modules  such  as  a  SPOOL  buffer  or  the  extended  DEBUG  code)  are  identified 
by  a  standard  front-end  header: 

BEGIN:   JR   START         !Go  to  actual  code 

tbedinnin* 

DEFW  END-1         {Contains  the  highest  byte 

Jof  Memory 
*used  by  the  Module 

DEFB  10  »Len*th  of  name*  1-15 

{characters  5 
ibits  4-7  reserved  for 
{system  use 

OEFM  'NAMESTRING'  iUp  to  15  alphanumeric 

{characters!  with  the  first 
{character  A-Z.  This  should 
{be  a  unique  name  to 
{positively  identify  the 
{module* 
MODDCB:  DEFW  4-$  !DCB  pointing  to  this 

{module  (if  applicable) 

DEFW  (9  {Spare  system  pointer  - 

{RESERVED 

; 

{       Any  additional  data  storage  does  here 

» 

START:   Start  of  actual  program  code 

END:    EQU  * 

As  explained  under  the  @GTMOD  SVC  in  the  "Supervisor  Call"  section,  the 
location  of  a  specific  header  can  be  found  provided  all  modules  that  are  put  into 
memory  use  this  header  structure.  You  can  locate  the  data  area  for  a  module 
by  using  @GTMOO  to  find  the  start  of  the  header  and  then  indexing  in  to  the 
data  area. 


Q 
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5/Drive  Access 


Drive  Code  Table  (DOT) 


TRSDOS  uses  a  Drive  Code  Table  (DCT)  to  interface  the  operating  system  with 
specific  disk  driver  routines.  Note  especially  the  fields  that  specify  the  allocation 
scheme  for  a  given  drive.  This  data  is  essential  in  the  allocation  and  accessi- 
bility of  file  records. 

The  DCT  contains  eight  10-byte  positions  —  one  for  each  logical  drive  des- 
ignated 0-7.  TRSDOS  supports  a  standard  configuration  of  two-floppy 
drives.  You  may  have  up  to  four  floppy  drives.  This  is  the  default  initializa- 
tion when  TRSDOS  is  loaded. 

Here  is  the  Drive  Code  Table  layout: 

DCT+0 

This  is  the  first  byte  of  a  3-byte  vector  to  the  disk  I/O  driver  routines.  This  byte 
is  normally  X'C3.'  If  the  drive  is  disabled  or  has  not  been  configured  (see  the 
SYSTEM  command  in  the  Disk  System  Owner's  Manual),  this  byte  is  a  RET 
instruction  (X'C9*). 

DCT+1  andDCT+2 

Contain  the  entry  address  of  the  routines  that  drive  the  physical  hardware. 

DCT+3 

Contains  a  series  of  flags  for  drive  specifications. 

Bit  7 — Set  to "  1 "  if  the  drive  is  software  write  protected,  "0"  if  it  is  not.  {See 
the  SYSTEM  command  in  the  Disk  System  Owner's  Manual.) 

Bit  6— Set  to  "1"  for  DDEN  (double  density),  or  "0"  for  SDEN  (single 
density). 

Bit  5— Set  to  "1"  if  the  drive  is  an  8"  drive.  Set  to  "0"  if  it  is  a  SVa"  drive. 

Bit  4 — A  "1"  causes  the  selection  of  the  disk's  second  side.  The  first  side 
is  selected  if  this  bit  is  "0."  This  bit  value  matches  the  side  indicator 
bit  in  the  sector  header  written  by  the  Floppy  Disk  Controller 
(FDC). 

Bit  3 — A  "1"  indicates  a  hard  drive  (Winchester).  A  "0"  denotes  a  floppy 
drive(5V4"or8"). 

Bit  2 — Indicates  the  time  delay  between  selection  of  a  SW  drive  and  the 
first  poll  of  the  status  register.  A  "1"  value  indicates  0.5  second  and 
a  "0"  indicates  1.0  second.  See  the  SYSTEM  command  in  the  Disk 
System  Owner's  Manual  for  more  details. 

If  the  drive  is  a  hard  drive,  this  bit  indicates  either  a  fixed  or  remov- 
able disk:  "1" =ftxed,  "0"  =  removable. 

Bits  1  and  0 — Contain  the  step  rate  specification  for  the  Floppy  Disk  Con- 
troller. (See  the  SYSTEM  command  in  the  Disk  System  Owner's 
Manual.)  In  the  case  of  a  hard  drive,  this  field  may  indicate  the  drive 
address  (0-3). 

DCT+4 

Contains  additional  drive  specifications. 

Bit  7—  (Version  6.2  only)  If  "1 ",  no  @CKDRV  is  done  when  accessing  the 
drive.  If  an  application  opens  several  files  on  a  drive,  this  bit  can  be 
set  to  speed  I/O  on  that  drive  after  the  first  successful  open  is 
performed. 
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In  versions  prior  to  TRSDOS  6.2,  this  bit  is  reserved  for  future  use. 
In  order  to  maintain  compatibility  with  future  releases  of  TRSDOS, 
do  not  use  this  bit. 

Bit  6  —  If  "1",  the  controller  is  capable  of  double-density  mode. 

Bit  5 — "1"  indicates  that  this  is  a  2-sided  floppy  diskette;  "0"  indicates  a 
1-sided  floppy  disk.  Do  not  confuse  this  bit  with  Bit  4  of  OCT +3. 
This  bit  shows  if  the  disk  is  double-sided;  Bit  4  of  DCT + 3  tells  the 
controller  what  side  the  current  I/O  is  to  be  on. 

If  the  hard  drive  bit  (DCT +3,  Bit  3)  is  set,  a  "1"  denotes  double  the 
cylinder  count  stored  in  DCT+6.  (This  implies  that  a  logical  cylin- 
der is  made  up  of  two  physical  cylinders.) 

Bit  4 — If  "1"  indicates  an  alien  (non-standard)  disk  controller. 

Bits  0-3 — Contain  the  physical  drive  address  by  bit  selection  (0001, 0010, 
0100,  and  1000  equal  logical  Drives  0, 1, 2,  and  3,  respectively,  in 
a  default  system).  The  system  supports  a  translation  only  where  no 
more  than  one  bit  can  be  set. 


If  the  alien  bit  (Bit  4)  is  set,  these  bits  may  indicate  the  starting  head 
number. 


DCT+5 


Contains  the  current  cylinder  position  of  the  drive.  It  normally  stores  a  copy  of 
the  Floppy  Disk  Controller's  track  register  contents  whenever  the  FDC  is 
selected  for  access  to  this  drive.  It  can  then  be  used  to  reload  the  track  register 
whenever  the  FDC  is  reselected. 

If  the  alien  bit  (DCT + 4,  Bit  4)  is  set,  DCT  +  5  may  contain  the  drive  select  code 
for  the  alien  controller. 

DCT+6 

Contains  the  highest  numbered  cylinder  on  the  drive.  Since  cylinders  are  num- 
bered from  zero,  a  35-track  drive  is  recorded  as  X'22,'  a  40-track  drive  as  X'27/ 
and  an  80-track  drive  as  X'4F.'  If  the  hard  drive  bit  (DCT + 3,  Bit  3)  is  set,  the  true 
cylinder  count  depends  on  DCT +4,  Bit  5.  If  that  bit  is  a  "1,"  DCT+6  contains 
only  half  of  the  true  cylinder  count. 

DCT+7 

Contains  allocation  information. 

Bits  5-7 — Contain  the  number  of  heads  for  a  hard  drive. 

Bits  0-4 — Contain  the  highest  numbered  sector  relative  to  zero.  A  10- 
sector-per-track  drive  would  show  XW  If  DCT +4,  Bit  5  indicates 
2-sided  operation,  the  sectors  per  cylinder  equals  twice  this 
number. 

DCT+8 

Contains  additional  allocation  information. 

Bits  5-7 — Contain  the  number  of  granules  per  track  allocated  in  the  for- 
matting process.  If  DCT +4,  Bit  5  indicates  2-sided  operation,  the 
granules  per  cylinder  equals  twice  this  number.  For  a  hard  drive, 
this  number  is  the  total  granules  per  cylinder. 

Bits  0-4 — Contain  the  number  of  sectors  per  granule  that  was  used  in  the 
formatting  operation. 

DCT+9 

Contains  the  number  of  the  cylinder  where  the  directory  is  located.  For  any 
directory  access,  the  system  first  attempts  to  use  this  value  to  read  the  direc- 
tory. If  this  operation  is  unsuccessful,  the  system  examines  the  BOOT  granule 
(cylinder  0)  directory  address  byte. 
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Bytes  DCT + 6,  DCT + 7,  and  DCT + 8  must  relate  without  conflicts.  That  is,  the 
highest  numbered  sector  (  +  1)  divided  by  the  number  of  sectors  per  granule 
{ + 1 )  must  equal  the  number  of  granules  per  track  ( + 1 ). 


Disk  I/O  Table 


.XgteM 


TRSDOS  interfaces  with  hardware  peripherals  by  means  of  software  drivers. 
The  drivers  are,  in  general,  coupled  to  the  operating  system  through  data 
parameters  stored  in  the  system's  many  tables.  In  this  way,  hardware  not  cur- 
rently supported  by  TRSDOS  can  easily  be  supported  by  generating  driver  soft- 
ware and  updating  the  system  tables. 

Disk  drive  sub-systems  (such  as  controllers  for  SVi"  drives,  8"  drives,  and  hard 
disk  drives)  have  many  parameters  addressed  in  the  Drive  Code  Table  (DCT). 
Besides  those  operating  parameters,  controllers  also  require  various  com- 
mands (SELECT,  SECTOR  READ,  SECTOR  WRITE,  and  so  on)  to  control  the 
physical  devices.  TRSDOS  has  defined  command  conventions  to  deal  with 
most  commands  available  on  standard  Disk  Controllers. 

The  function  value  (hexadecimal  or  decimal)  you  wish  to  pass  to  the  driver 
should  go  in  register  B.  The  available  functions  are: 

Hex       Dec        Function Operation  Performed 

Test  to  see  if  drive  is  assigned  in  DCT 
Select  a  new  drive  and  return  status 
Set  to  cylinder  0,  restore,  set  side  0 
Reset  the  Floppy  Disk  Controller 
Issue  FDC  RESTORE  command 
Issue  FDC  STEP  IN  command 
Seek  a  cylinder 

lest  to  see  if  requested  drive  is  busy 
Read  sector  header  information 
Read  sector 

Verify  if  the  sector  is  readable 
Issue  an  FDC  track  read  command 
Format  the  device 
Write  a  sector 

Write  a  system  sector  (for  example,  directory) 
Issue  an  FDC  track  write  command 
Function  codes  X'10'  to  X'FF'  are  reserved  for  future  use. 


xw 

0 

DCSTAT 

x'or 

1 

SELECT 

X02' 

2 

DCINIT 

XW 

3 

DCRES 

X'04' 

4 

RSTOR 

X'05' 

5 

STEPI 

XW 

6 

SEEK 

xw 

7 

TSTBSY 

X'08' 

8 

RDHDR 

XW 

9 

RDSEC 

X'OA 

10 

VRSEC 

X'OB' 

11 

RDTRK 

X'0C" 

12 

HDFMT 

XW 

13 

WRSEC 

X'0E" 

14 

WRSYS 

X'OF 

15 

WRTRK 

Directory  Records  (DIREC) 


The  directory  contains  information  needed  to  access  all  files  on  the  disk.  The 
directory  records  section  is  limited  to  a  maximum  of  32  sectors  because  of 
physical  limitations  in  the  Hash  Index  Table.  Two  additional  sectors  in  the  direc- 
tory cylinder  are  used  by  the  system  for  the  Granule  Allocation  Table  and  the 
Hash  Index  Table.  The  directory  is  contained  on  one  cylinder.  Thus,  a  10-sector- 
per-cylinder  formatted  disk  has,  at  most,  eight  directory  sectors.  See  the  sec- 


Software  13 


Sectors 

User  Files 

User 

per 

Directory 

on  Data 

Files  on 

Cylinder 

Sectors 

Disk" 

SYS  Disk 

10 

8 

62 

48 

20 

18 

142 

128 

18 

16 

126 

112 

36 

32 

254 

240 

16 

14 

110 

96 

32 

30 

238 

224 

30 

28 

222 

208 

60 

32 

254 

240 

tion  on  the  Hash  Index  Table  for  the  formula  to  calculate  the  number  of  directory 
sectors. 

A  directory  record  is  32  bytes  in  length.  Each  directory  sector  contains  eight 
directory  records  (256/32  =  8).  On  system  disks,  the  first  two  directory  records 
of  the  first  eight  directory  sectors  are  reserved  for  system  overlays.  The  total 
number  of  files  possible  on  a  disk  equals  the  number  of  directory  sectors  times 
eight  (since  256/32= 8).  The  number  available  for  use  is  reduced  by  16  on  sys- 
tem disks  to  account  for  those  record  slots  reserved  for  the  operating  system. 
The  following  table  shows  the  directory  record  capacity  (file  capacity)  of  each 
format  type.  The  dash  suffix  (-1  or  -2)  on  the  items  in  the  density  column  rep- 
resents the  number  of  sides  formatted  (for  example,  SDEN-1  means  single 
density,  1-sided). 


5"  SDEN-1 
5"  SDEN-2 
5"  DDEN-1 
5"  DDEN-2 
8"  SDEN-1 
8"  SDEN-2 
8"  DDEN-1 
8"  DDEN-2 
Hard  Disk* 

*Hard  drive  format  depends  on  the  drive  size  and  type,  as  well  as  the  user's 
division  of  the  physical  drive  into  logical  drives.  After  setting  up  and  format- 
ting the  drive,  you  can  use  the  FREE  library  command  to  see  the  available 
files. 

"Note:  Two  directory  records  are  reserved  for  BOOT/SYS  and  DIR/SYS, 
and  are  included  in  the  figures  for  this  column. 

TRSDOS  Version  6  is  upward  compatible  with  other  TRSDOS  2.3  compatible 
operating  systems  in  its  directory  format.  The  data  contained  in  the  directory 
has  been  extended.  An  SVC  is  included  to  either  display  an  abbreviated  direc- 
tory or  place  its  data  in  a  user-defined  buffer  area.  For  detailed  information,  see 
the  @DODIR  and  @RAMDIR  SVCs. 

The  following  information  describes  the  contents  of  each  directory  field: 

DIR+0 

Contains  all  attributes  of  the  designated  file. 

Bit  7 — If  "0,"  this  flag  indicates  that  the  directory  record  is  the  file's  primary 
directory  entry  (FPDE).  If  "1,"  the  directory  record  is  one  of  the  file's 
extended  directory  entries  (FXDE).  Since  a  directory  entry  can 
contain  information  on  up  to  four  extents  (see  notes  on  the  extent 
fields,  beginning  with  DIR+22),  a  file  that  is  fractured  into  more 
than  four  extents  requires  additional  directory  records. 

Bit  6— Specifies  a  SYStem  file  if  'T  a  nonsystem  file  if  "0:" 

Bit  5— If  set  to  "1!'  indicates  a  Partition  Data  Set  (PDS)  file. 

Bit  4 — Indicates  whether  the  directory  record  is  in  use  or  not.  If  set  to  "1," 
the  record  is  in  use.  If  "0,"  the  directory  record  is  not  active, 
although  it  may  appear  to  contain  directory  information.  In  contrast 
to  some  operating  systems  that  zero  out  the  directory  record  when 
you  remove  a  file,  TRSDOS  only  resets  this  bit  to  zero. 

Bit  3 — Specifies  the  visibility.  If  "1,"  the  file  is  INVisible  to  a  directory  dis- 
play or  other  library  function  where  visibility  is  a  parameter.  If  a  "0," 
then  the  file  is  Visible.  (The  file  can  be  referenced  if  specified  by 
name  by  an  @INIT  or  ©OPEN  SVC.) 
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Bits  0-2— Contain  the  USER  protection  level  of  the  file.  The  3-bit  binary 
value  is  one  of  the  following: 

0  =  FULL  2  =  RENAME     4  =  UPDATE      6  =  EXECUTE 

1=  REMOVE     3  =  WRITE         5  =  READ         7  =  NO  ACCESS 

DIR  +  1 

Contains  various  file  flags  and  the  month  field  of  the  packed  date  of  last 
modification. 

Bit  7— Set  to  "1"  if  the  file  was  "CREATEd"  (see  CREATE  library  com- 
mand in  the  Disk  System  Owner's  Manual).  Since  the  CREATE 
command  can  reference  a  file  that  is  currently  existing  but  non- 
CREATEd,  it  can  turn  a  non-CREATEd  file  into  a  CREATEd  one. 
You  can  achieve  the  same  effect  by  changing  this  bit  to  a  "1." 

Bit  6 — If  set  to  "1,"  the  file  has  not  been  backed  up  since  its  last  modifica- 
tion. The  BACKUP  utility  is  the  only  TRSDOS  facility  that  resets 
this  flag.  It  is  set  during  the  close  operation  if  the  File  Control  Block 
(FCB+0,  Bit  2)  shows  a  modification  of  file  data. 

Bit  5 — If  set  to  "1,"  indicates  a  file  in  an  open  condition  with  UPDATE 
access  or  greater. 

Bit  4 — If  the  file  was  modified  during  a  session  where  the  system  date  was 
not  maintained,  this  bit  is  set  to  "1"  This  specifies  that  the  packed 
date  of  modification  (if  any)  stored  in  the  next  three  fields  is  not  the 
actual  date  the  modification  occurred.  If  this  bit  is  "1,"  the 
directory  command  displays  plus  signs  ( + )  between  the  date 
fields. 

Bits  0-3 — Contain  the  binary  month  of  the  last  modification  date.  If  this 
field  is  a  zero,  DATE  was  not  set  when  the  file  was  established  or 
since  if  it  was  updated. 

DIR  +  2 

Contains  the  remaining  date  of  modification  fields. 

Bits  3-7— Contain  the  binary  day  of  last  modification. 

Bits  0-2 — Contain  the  binary  year  minus  80.  For  example,  1980  is  coded 
as  000, 1981  as  001, 1982  as  010,  and  so  on. 

DIR  +  3 

Contains  the  end-of-file  offset  byte.  This  byte  and  the  ending  record  number 
(ERN)  form  a  pointer  to  the  byte  position  that  follows  the  last  byte  written.  This 
assumes  that  programmers,  interfacing  in  machine  language,  properly  main- 
tain the  next  record  number  (NRN)  offset  pointer  when  the  file  is  closed. 

DIR+4 

Contains  the  logical  record  length  (LRL)  specified  when  the  file  was  generated 
or  when  it  was  later  changed  with  a  CLONE  parameter. 

DlR + 5  through  OIR + 12 

Contain  the  name  field  of  the  filespec.  The  filename  is  left  justified  and  padded 
with  trailing  blanks. 

DlR  + 13  through  DlR + 15 

Contain  the  extension  field  of  the  filespec.  It  is  left  justified  and  padded  with 
trailing  blanks. 

DlR +  16  and  DlR +17 

Contain  the  OWNER  password  hash  code. 

DlR +18  and  DlR +  19 

Contain  the  USER  password  hash  code.  The  protection  level  in  DlR + 0  is  asso- 
ciated with  this  password. 
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DIR+20andDIR+21 

Contain  the  ending  record  number  (ERN),  which  is  based  on  full  sectors.  If  the 
ERN  is  zero,  it  indicates  that  no  writing  has  taken  place  (or  that  the  file  was  not 
closed  properly) .  If  the  LRL  is  not  256,  the  ERN  represents  tile  sector  where  the 
EOF  occurs.  You  should  use  ERN  minus  1  to  account  for  a  value  relative  to  sec- 
tor 0  of  the  file. 

DIR+22andDIR+23 

This  is  the  first  extent  field.  Its  contents  indicate  which  cylinder  stores  the  first 
granule  of  the  extent,  which  relative  granule  it  is,  and  how  many  contiguous 
grans  are  in  use  in  the  extent. 

DIR + 22 — Contains  the  cylinder  value  for  the  starting  gran  of  that  extent. 

Dl  R + 23,  Bits  5-7 — Contain  the  number  of  the  granule  in  the  cylinder  indi- 
cated by  DIR +22  which  is  the  first  granule  of  the  file  for  that 
extent.  This  value  is  relative  to  zero  ("0"  denotes  the  first  gran, 
"1"  denotes  the  second,  and  so  on). 

DIR +23,  Bits  0-4 — Contain  the  number  of  contiguous  granules,  relative 
to  0  ("0"  denotes  one  gran,  "1"  denotes  two,  and  so  on).  Since 
the  field  is  five  bits,  it  contains  a  maximum  of  X'l  F  or  31,  which 
represents  32  contiguous  grans. 

DIR+24andDIR+25 

Contain  the  fields  for  the  second  extent.  The  format  is  identical  to  that  for 
Extent  1. 

DIR+26andDIR+27 

Contain  the  fields  for  the  third  extent.  The  format  is  identical  to  that  for  Extent  1. 

DiR+28andDIR+29 

Contain  the  fields  for  the  fourth  extent.  The  format  is  identical  to  that  for 
Extent  1. 

DIR +30 

This  is  a  flag  noting  whether  or  not  a  link  exists  to  an  extended  directory  record. 
If  no  further  directory  records  are  linked,  the  byte  contains  X'FF*  A  value  of  X'FE' 
in  this  byte  establishes  a  link  to  an  extended  directory  entry.  (See  "Extended 
Directory  Records"  below.) 

DIR +31 

This  is  the  link  to  the  extended  directory  entry  noted  by  the  previous  byte.  The 
link  code  is  the  Directory  Entry  Code  (DEC)  of  the  extended  directory  record. 
The  DEC  is  actually  the  position  of  the  Hash  Index  Table  byte  mapped  to  the 
directory  record.  For  more  information,  see  the  section  "Hash  Index  Table." 

Extended  Directory  Records 

Extended  directory  records  (FXDE)  have  the  same  format  as  primary  directory 
records,  except  that  only  Bytes  0, 1,  and  21-31  are  utilized.  Within  Byte  0,  only 
Bits  4  and  7  are  significant.  Byte  1  contains  the  DEC  of  the  directory  record  of 
which  this  is  an  extension.  An  extended  directory  record  may  point  to  yet 
another  directory  record,  so  a  file  may  contain  an  "unlimited"  number  of  extents 
(limited  only  by  the  total  number  of  directory  records  available). 


Granule  Allocation  Table  (GAT) 


The  Granule  Allocation  Table  (GAT)  contains  information  on  the  free  and 
assigned  space  on  the  disk.  The  GAT  also  contains  data  about  the  formatting 
used  on  the  disk. 
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A  disk  is  divided  into  cylinders  (tracks)  and  sectors.  Each  cylinder  has  a  spec- 
ified number  of  sectors.  A  group  of  sectors  is  allocated  whenever  additional 
space  is  needed.  This  group  is  called  a  granule.  The  number  of  sectors  per 
granule  depends  on  the  total  number  of  sectors  available  on  a  logical  drive.  The 
GAT  provides  for  a  maximum  of  eight  granules  per  cylinder. 

In  the  GAT  bytes,  each  bit  set  to  "1"  indicates  a  corresponding  granule  in  use 
(or  locked  out).  Each  bit  reset  to  "0"  indicates  a  granule  free  to  be  used.  In  a 
GAT  byte,  bit  0  corresponds  to  the  first  relative  granule,  bit  1  to  the  second  rel- 
ative granule,  bit  2  the  third,  and  so  on.  A  5  W  single  density  diskette  is  format- 
ted at  10  sectors  per  cylinder,  5  sectors  per  granule,  2  granules  per  cylinder. 
Thus,  that  configuration  uses  only  bits  0  and  1  of  the  GAT  byte.  The  remainder 
of  the  GAT  byte  contains  all  1's,  denoting  unavailable  granules.  Other  formatting 
conventions  are  as  follows: 


Sectors 

Sectors 

Granules 

Maximum 

per 

per 

per 

No.  of 

Cylinder 

Granule 

Cylinder 

Cylinders 

5"  SDEN 

10 

5 

2 

80 

5"  DDEN 

18 

6 

3 

80 

8"  SDEN 

16 

8 

2 

77 

8"  DDEN 

30 

10 

3 

77 

Hard  Disk 

32 

16 

8 

153 

"Hard  drive  format  depends  on  the  drive  size  and  type,  as  well  as  the  user's  divi- 
sion of  the  drive  into  logical  drives.  These  values  assume  that  one  physical 
hard  disk  is  treated  as  one  logical  drive. 

The  above  table  is  valid  for  single-sided  disks.  TRSDOS  supports  double-sided 
operation  if  the  hardware  interfacing  the  physical  drives  to  the  CPU  allows  it.  A 
two-headed  drive  functions  as  a  single  logical  drive,  with  the  second  side  as  a 
cylinder-for-cylinder  extension  of  the  first  side.  A  bit  in  the  Drive  Code  Table 
(DCT+4,  Bit  5)  indicates  one-sided  or  two-sided  drive  configuration. 

A  Winchester-type  hard  disk  can  be  divided  by  heads  into  multiple  logical 
drives.  Details  are  supplied  with  Radio  Shack  drives. 

The  Granule  Allocation  Table  is  the  first  relative  sector  of  the  directory  cylinder. 
The  following  information  describes  the  layout  and  contents  of  the  GAT. 

GAT+X'00'  through  GAT+X'5F 

Contains  the  free/assigned  table  information.  GAT+ 0  corresponds  to  cylinder 
0,  GAT + 1  corresponds  to  cylinder  1,  GAT + 2  corresponds  to  cylinder  2,  and  so 
on.  As  noted  above,  bit  0  of  each  byte  corresponds  to  the  first  granule  on  the 
cylinder,  bit  1  to  the  second  granule,  and  so  on.  A  value  of  "1"  indicates  the 
granule  is  not  available  for  use. 

GAT+X'60'  through  GAT+X'BF* 

Contains  the  available/locked  out  table  information.  It  corresponds  cylinder  for 
cylinder  in  the  same  way  as  the  free/assigned  table.  It  is  used  during  mirror- 
image  backups  to  determine  if  the  destination  diskette  has  the  proper  capacity 
to  effect  a  backup  of  the  source  diskette.  This  table  does  not  exist  for  hard 
disks;  for  this  reason,  mirror-image  backups  cannot  be  performed  on  hard  disk. 

GAT+X'CO'  through  GAT+X'CA' 

Used  in  hard  drive  configurations;  extends  the  free/assigned  table  from  X'00' 
through  X'CA.  Hard  drive  capacity  up  to  203  (0-202)  logical  or  406  physical  cyl- 
inders is  supported. 

GAT+X'CB' 

Contains  the  operating  system  version  that  was  used  in  formatting  the  disk. 
For  example,  disks  formatted  under  TRSDOS  6.2  have  a  value  of  X'62' 
contained  in  this  byte.  It  is  used  to  determine  whether  or  not  the  disk 
contains  all  of  the  parameters  needed  for  TRSDOS  operation. 
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GAT+X'CC 

Contains  the  number  of  cylinders  in  excess  of  35.  It  is  used  to  minimize  the  time 
required  to  compute  the  highest  numbered  cylinder  formatted  on  the  disk.  It  is 
excess  35  to  provide  compatibility  with  alien  systems  not  maintaining  this  byte. 
If  you  have  a  disk  that  was  formatted  on  an  alien  system  for  other  than  35  cyl- 
inders, this  byte  can  be  automatically  configured  by  using  the  REPAIR  utility. 
(See  the  section  on  the  REPAIR  utility  in  the  Disk  System  Owner's  Manual.) 

GAT+X'CD' 

Contains  data  about  the  formatting  of  the  disk. 

Bit  7— If  set  to  "1,"  the  disk  is  a  data  disk.  If  "0,"  the  disk  is  a  system  disk. 

Bit  6 — If  set  to  "1,"  indicates  double-density  formatting.  If  "0,"  indicates 
single-density  formatting. 

Bit  5— If  set  to  "1,"  indicates  2-sided  disk.  If  "0,"  indicates  1-sided  disk. 

Bits  3-4 — Reserved. 

Bits  0-2 — Contain  the  number  of  granules  per  cylinder  minus  1. 

GAT+X'CE'  and  GAT+X'CF 

Contain  the  16-bit  hash  code  of  the  disk  master  password.  The  code  is  stored 
in  standard  low-order,  high-order  format. 

GAT+XW  through  GAT+X'D7' 

Contain  the  disk  name.  This  is  the  name  displayed  during  a  FREE  or  DIR  oper- 
ation. The  disk  name  is  assigned  during  formatting  or  during  an  ATTRIB  disk 
renaming  operation.  The  name  is  left  justified  and  padded  with  blanks. 

GAT+XD8'  through  GAT+X'DF 

Contain  the  date  that  the  diskette  was  formatted  or  the  date  that  it  was  used  as 
the  destination  in  a  mirror  image  backup  operation  in  the  format  mm/dd/yy. 

GAT+X'EO'  through  GAT+X'FP 

Reserved  for  system  use. 

In  Version  6.2: 

GAT+X'EO'  through  GAT  +  X'F4' 

Reserved  for  system  use. 

GAT+XF5'  through  GAT+X'FF 

Contain  the  Media  Data  Block  (MDB). 

GAT  +  X'F5'  through  GAT  +  X'F8'  —  the  identifying  header.  These  four 
bytes  contain  a  3  <XW),  followed  by  the  letters  LSI  (XW.X'SS'.XW). 

GAT  +  X'F8'  through  GAT9  +  X'FF  —  the  last  seven  bytes  of  the  OCT 
in  use  when  the  media  was  formatted.  FORMAT,  MemDISK,  and 
TRSFORM6  install  this  information.  See  Drive  Control  Table  (DCT)  for 
more  information  on  these  bytes. 


Hash  Index  Table  (HIT) 


The  Hash  Index  Table  is  the  key  to  addressing  any  file  in  the  directory.  It  pin- 
points the  location  of  a  file's  directory  with  a  minimum  of  disk  accesses,  keeping 
overhead  low  and  providing  rapid  file  access. 

The  system's  procedure  is  to  construct  an  11-byte  filename/extension  field.  The 
filename  is  left-justified  and  padded  with  blanks.  The  file  extension  is  then 
inserted  and  padded  with  blanks;  it  occupies  the  three  least  significant  bytes  of 
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the  11-byte  field.  This  field  is  processed  through  a  hashing  algorithm  which  pro- 
duces a  single  byte  value  in  the  range  X'01'  through  X'FR  (A  hash  value  of  X'OO' 
indicates  a  spare  HIT  position.) 

The  system  then  stores  the  hash  code  in  the  Hash  Index  Table  (HIT)  at  a  posi- 
tion corresponding  to  the  directory  record  that  contains  the  file's  directory.  Since 
more  than  one  11-byte  string  can  hash  to  identical  codes,  the  opportunity  for 
"collisions"  exists.  For  this  reason,  the  search  algorithm  scans  the  HIT  for  a 
matching  code  entry,  reads  the  directory  record  corresponding  to  the  matching 
HIT  position,  and  compares  the  filename/extension  stored  in  the  directory  with 
that  provided  in  the  file  specification.  If  both  match,  the  directory  has  been 
found.  If  the  two  fields  do  not  match,  the  HIT  entry  was  a  collision  and  the  algo- 
rithm continues  its  search  from  the  next  HIT  entry 

The  position  of  the  HIT  entry  in  the  hash  table  is  called  the  Directory  Entry  Code 
(DEC)  of  the  file.  All  files  have  at  least  one  DEC.  Files  that  are  extended  beyond 
four  extents  have  a  DEC  for  each  extended  directory  entry  and  use  more  than 
one  filename  slot.  To  maximize  the  number  of  file  slots  available,  you  should 
keep  your  files  below  five  extents  where  possible. 

Each  HIT  entry  is  mapped  to  the  directory  sectors  by  the  DEC's  position  in  the 
HIT.  Think  of  the  HIT  as  eight  rows  of  32-byte  fields.  Each  row  is  mapped  to  one 
of  the  directory  records  in  a  directory  sector:  The  first  HIT  row  is  mapped  to  the 
first  directory  record,  the  second  HIT  row  to  the  second  directory  record,  and  so 
on.  Each  column  of  the  HIT  field  (0-31 )  is  mapped  to  a  directory  sector.  The  first 
column  is  mapped  to  the  first  directory  sector  in  the  directory  cylinder  (not 
including  the  GAT  and  HIT).  Therefore,  the  first  column  corresponds  to  sector 
2,  the  second  column  to  sector  3,  and  so  on.  The  maximum  number  of  HIT  col- 
umns used  depends  on  the  disk  formatting  according  to  the  formula: 
N  =  number  of  sectors  per  cylinder  minus  two,  up  to  32. 

The  following  chart  shows  the  correlation  of  the  Hash  Index  Table  to  the  direc- 
tory records.  Each  byte  value  shown  represents  the  position  in  the  HIT.  This 
position  value  is  the  DEC.  The  actual  contents  of  each  byte  is  either  a  X(00) 
indicating  a  spare  slot,  or  the  1-byte  hash  code  of  the  file  that  occupies  the  cor- 
responding directory  record. 

Columns         

Row1     00     01      02     03     04      05      06      07     08     09     0A     OB     0C     00     0E     OF 
10      11      12      13      14      15      16      17      18      19      1A     16     1C     ID     IE     1F 

Row2    20     21      22      23     24     25      26      27     28     29     2A     2B     2C     2D     2E     2F 
30     31      32     33     34     35      36      37     38     39     3A     3B     3C    3D     3E     3F 

Row3    40     41      42      43     44     45     46      47     48     49     4A     4B     4C     4D     4E     4F 
50      51      52      53      54      55      56      57     56     59     5A     5B     5C     5D     5E     5F 

Row  4    60      61      62      63      64      65      66      67      68      69      6A     6B     6C     6D     6E     6F 
70      71       72      73      74      75      76      77      78      79      7A     7B     7C     7D     7E      7F 

Row5    80     81      82      63     64     85      86     87     88     89     8A     8B     8C    80     8E     8F 
90     91      92      93      94     95     96      97     98     99     9A     9B     9C    9D     9E     9F 

Row  6    AO     A1      A2     A3     A4     AS     A6     A7     A8     A9     AA    AB     AC    AO     AE     AF 
BO     B1      B2     B3     B4     B5     B6     B7     B8     B9     BA    BB     BC    BD     BE     BF 

Row7    CO     C1     C2     C3     C4     C5     C6     C7     C8     C9     CA    CB    CC    CD     CE     CF 
DO     D1     D2     D3     D4     D5     D6     D7     D8     D9     DA     DB    DC    DD     DE     DF 

ROWS    EO     E1      E2     E3     E4     E5     E6     E7     EB     E9     EA     EB     EC    ED     EE     EF 
FO     F1      F2     F3     F4     F5     F6      F7     F8     F9     FA     FB     FC     FD     FE     FF 

A  514"  single  density  disk  has  1 0  sectors  per  cylinder,  two  of  which  are  reserved 
for  the  GAT  and  HIT.  Since  only  eight  directory  sectors  are  possible,  only  the 
first  eight  positions  of  each  HIT  row  are  used.  Other  formats  use  more  columns 
of  the  HIT,  depending  on  the  number  of  sectors  per  cylinder  in  the  formatting 
scheme. 

The  eight  directory  records  for  sector  2  of  the  directory  cylinder  correspond  to 
assignments  in  HIT  positions  00,  20,  40,  60,  80,  AO,  CO,  and  E0.  On  system 
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disks,  the  following  positions  are  reserved  for  system  overlays.  On  data  disks, 
these  positions  (except  for  00  and  01)  are  available  to  the  user. 

00  — BOOT/SYS  20  — SYS6/SYS 

01  —  DIR/SYS  21  —  SYS7/SYS 

02  —  SYS0/SYS  22  —  SYS8/SYS 

03  —  SYS1  /SYS  23  —  SYS9/SYS 

04  —  SYS2/SYS  24  —  SYS1 0/SYS 

05  —  SYS3/SYS  25  —  SYS1 1  /SYS 

06  —  SYS4/SYS  26  —  SYS1 2/SYS 

07  —  SYS5/SYS  27  —  SYS1 3/SYS 

These  entry  positions  correspond  to  the  first  two  rows  of  each  directory  sector 
for  the  first  eight  directory  sectors.  Since  the  operating  system  accesses  these 
overlays  by  position  in  the  HIT  rather  than  by  filename,  these  positions  are 
reserved  on  system  disks. 

The  design  of  the  Hash  Index  Table  limits  the  number  of  files  on  any  one  drive 
to  a  maximum  of  256. 


Locating  a  Directory  Record 


Because  of  the  coding  scheme  used  on  the  entries  in  the  HIT  table,  you  can 
locate  a  directory  record  with  only  a  few  instructions.  The  instructions  are: 


AND  1FH 

ADD  A»2 

and 

AND  0E0H 


(calculates  the  sector) 


(calculates  the  offset  in  that  sector) 


For  example,  if  you  have  a  Directory  Entry  Code  (DEC)  of  X'84',the  following 
occurs  when  these  instructions  are  performed: 

Value  of  accumulator 
A=X'84' 

AND      1FH 

A=X'04' 

ADD      A .2 

A=X'06' 

The  record  is  in  the  seventh 

sector  of  the  directory  cylinder 

(0-6) 

Using  the  Directory  Entry  Code  (DEC)  again,  you  can  find  the  offset  into  the 
sector  that  was  found  using  the  above  instructions  by  executing  one 
instruction: 


9 


AND      0E0H 


Value  of  accumulator 
A=X'84' 

A=X'80' 

The  directory  record  is  X'80'  (128) 
bytes  from  the  beginning  of 
the  sector 

If  the  record  containing  the  sector  is  loaded  on  a  256-byte  boundary  (LSB  of  the 
address  is  X'00')  and  HL  points  to  the  starting  address  of  the  sector,  then  you 
can  use  the  above  value  to  calculate  the  actual  address  of  the  directory  record 
by  executing  the  instruction: 

LD       L»A 
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When  executed  after  the  calculation  of  the  offset,  this  causes  HL  to  point  to  the 
record.  For  example: 

A=X'80" 

LD       HL  #  4200H     ;Where  sector  is  loaded 
LD       L » A  ;Replace  LSB  with  offset 

HL  now  contains  4280 H,  which  is  the  address  of  the  directory  record  you 
wanted. 

If  you  cannot  place  the  sector  on  a  256-byte  boundary,  then  you  can  use  the 
following  instructions: 

A=X'80' 

LD       HL  t4256H    .Where  sector  is  loaded 
LD       E  t  A  ;Put  offset  in  E  (LSB) 

LD       D  .  0  ;Put  a  zero  in  D  (MSB) 

ADD     HL  f  DE  ;Add  two  values  together 

HL  now  contains  42D6H,  which  is  the  address  of  the  directory  record. 

Note  that  the  first  DEC  found  with  a  matching  hash  code  may  be  the  file's 
extended  directory  entry  (FXDE).  Therefore,  if  you  are  going  to  write  system 
code  to  deal  with  this  directory  scheme,  you  must  properly  deal  with  the  FPDE/ 
FXDE  entries.  See  Directory  Records  for  more  information. 
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6/File  Control 


File  Control  Block  (FCB) 


The  File  Control  Block  (FCB)  is  a  32-byte  memory  area.  Before  the  file  is 
opened,  this  space  holds  the  file's  filespec.  After  an  @OPEN  or  @INIT  super- 
visor call  is  performed,  the  system  uses  this  area  to  interface  with  the  file,  and 
replaces  the  filespec  with  other  information.  When  the  file  is  closed,  the  filespec 
(without  any  specified  password)  is  returned  to  the  FCB. 

While  a  file  is  open,  the  contents  of  the  FCB  are  dynamic.  As  records  are  written 
to  or  read  from  the  disk  file,  specific  fields  in  the  FCB  are  modified.  Avoid  chang- 
ing the  contents  of  the  FCB  during  the  time  a  file  is  open,  unless  you  are  sure 
that  the  change  will  not  affect  the  integrity  of  the  file. 

During  most  system  access  of  the  FCB,  the  IX  index  register  is  used  to  refer- 
ence each  field  of  data.  Register  pair  DE  is  used  mainly  for  the  initial  reference 
to  the  FCB  address.  The  information  contained  in  each  field  of  the  FCB  is  as 
follows: 

FCB +0 

Contains  the  TYPE  code  of  the  control  block. 

Bit  7 — If  set  to  "1,"  indicates  that  the  file  is  in  an  open  condition;  if  "0,"  the 
file  is  assumed  closed.  This  bit  can  be  tested  to  determine  the 
"open"  or  "closed"  status  of  an  FCB. 

Bit  6 — Is  set  to  "1"  if  the  file  was  opened  with  UPDATE  access  or  higher. 

Bit  5— Indicates  a  Partition  Data  Set  (PDS)  type  file. 

Bits  4-3 — Reserved  for  future  use. 

Bit  2 — Is  set  to  "1"  if  the  system  performed  any  WRITE  operation  on  this 
file.  It  is  used  to  update  the  MOD  flag  in  the  directory  record  when 
the  file  is  closed. 

Bits  1-0 — Reserved  for  future  use. 

FCB  +  1 

Contains  status  flag  bits  used  in  read/write  operations  by  the  system. 

Bit  7 — If  set  to  "1"  indicates  that  I/O  operations  will  be  either  full  sector 
operations  or  byte  operations  of  logical  record  length  (LRL)  less 
than  256.  If  "0,"  only  sector  operations  will  be  performed.  If  you  are 
going  to  use  only  full-sector  I/O,  you  can  reduce  system  overhead 
by  specifying  the  LRL  at  open  time  as  0  (indicating  256).  An  LRL 
of  other  than  256  sets  bit  7  to  "1"  on  open. 

Bit  6 — If  set  to  "1,"  indicates  that  the  end  of  file  (EOF)  is  to  be  set  to  ending 
record  number  (ERN)  only  if  next  record  number  (NRN)  exceeds 
the  current  value  of  EOF.  This  is  the  case  if  random  access  is  to  be 
used.  During  random  access,  the  EOF  is  not  disturbed  unless  you 
extend  the  file  beyond  the  last  record  slot.  Any  time  the  position 
routine  (@POSN)  is  called,  bit  6  is  automatically  set.  If  bit  6  is  "0," 
then  EOF  will  be  updated  on  every  WRITE  operation. 

Bit  5 — If  "0,"  then  the  disk  I/O  buffer  contains  the  current  sector  denoted 
by  NRN.  If  set  to  "1,"  then  the  buffer  does  not  contain  the  current 
sector.  During  byte  I/O,  bit  5  is  set  when  the  last  byte  of  the  sector 
is  read.  A  sector  read  resets  the  bit,  showing  the  buffer  to  be 
current 
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Bit  4 — If  set  to  "1"  indicates  that  the  buffer  contents  have  been  changed 
since  the  buffer  was  read  from  the  file.  It  is  used  by  the  system  to 
determine  whether  the  buffer  must  be  written  back  to  the  file  before 
reading  another  record.  If  "0,"  then  the  buffer  contents  were  not 
changed. 

Bit  3 — Used  to  specify  that  the  directory  record  is  to  be  updated  each  time 
the  NRN  exceeds  the  EOF.  (The  normal  operation  is  to  update  the 
directory  only  when  an  FCB  is  closed.)  Some  unattended  opera- 
tions may  use  this  extra  measure  of  file  protection.  It  is  specified  by 
adding  an  exclamation  mark  ("!")  to  the  end  of  a  filespec  when  the 
filespec  is  requested  at  open  time. 

Bits  2-0 — Contain  the  user  (access)  protection  level  as  retrieved  from  the 
directory  of  the  file.  The  3-bit  binary  value  is  one  of  the  following: 

0=FULL  2  =  RENAME     4=  UPDATE      6  =  EXECUTE 

1  =  REMOVE     3= WRITE         5  =  READ  7  =  NO  ACCESS 

FCB +2 

Used  by  Partition  Data  Set  (PDS)  files. 

FCB+3andFCB+4 

Contain  the  buffer  address  in  low-order,  high-order  format.  This  is  the  buffer 
address  specified  in  register  pair  HL  when  the  @JNIT  or  ©OPEN  SVC  is 
performed. 

FCB +5 

Contains  the  relative  byte  offset  within  the  current  buffer  for  the  next  I/O  oper- 
ation. If  this  byte  has  a  zero  value,  then  FCB  + 1,  Bit  5  must  be  examined  to  see 
if  the  first  byte  in  the  current  buffer  is  the  target  position  or  if  it  is  the  first  byte  of 
the  next  record.-  If  you  are  performing  sector  I/O  of  byte  data  (that  is,  maintain- 
ing your  own  buffering),  then  it  is  important  to  maintain  this  byte  when  you  close 
the  file  if  the  true  end  of  file  is  not  at  a  sector  boundary. 

FCB +6 

Bits  3-7 — Reserved  for  system  use. 

Bits  0-2 — Contain  the  logical  drive  number  in  binary  of  the  drive  contain- 
ing the  file.  Do  not  modify  this  byte;  altering  this  value  may  damage 
other  files.  This  byte  and  FCB  +  7  are  the  only  links  to  the  file's 
directory  information. 

FCB+7 

Contains  the  directory  entry  code  (DEC)  for  the  file.  This  code  is  the  offset  in  the 
Hash  Index  Table  where  the  hash  code  for  the  file  appears.  Do  not  modify  this 
byte;  altering  this  value  may  damage  other  files.  This  byte  and  FCB + 6  are  the 
only  links  to  the  directory  information  for  the  file. 

FCB +8 

Contains  the  end-of-f ile  byte  offset.  This  byte  is  similar  to  FCB + 5  except  that  it 
pertains  to  the  end  of  file  rather  than  to  the  next  record  number. 

FCB +9 

Contains  the  logical  record  length  that  was  in  effect  when  the  file  was  opened. 
This  may  not  be  the  same  LRL  that  exists  in  the  directory.  The  directory  LRL  is 
generated  at  the  file  creation  and  never  changes  unless  the  file  is  overwritten. 

FCB+10andFCB+11 

Contain  the  next  record  number  (NRN),  which  is  a  pointer  for  the  next  I/O  oper- 
ation. When  a  file  is  opened,  NRN  is  zero,  indicating  a  pointer  to  the  beginning. 
Each  sequential  sector  I/O  advances  NRN  by  one. 
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FCB +12  and  FCB +  13 

Contain  the  ending  record  number  (ERN)  of  the  file.  This  is  a  pointer  to  the  sec- 
tor that  contains  the  end-of-file  indicator.  In  a  null  file  (one  with  no  records), 
ERN  equals  0.  If  one  sector  has  been  written,  ERN  equals  1. 

FCB  +  14andFCB  +  15 

Contain  the  same  information  as  the  first  extent  of  the  directory.  This  represents 
the  starting  cylinder  of  the  file  (FCB  +  14)  and  the  starting  relative  granule  within 
the  starting  cylinder  (FCB+ 15).  FCB  + 15  also  contains  the  number  of  contig- 
uous granules  allocated  in  the  extent.  These  bytes  are  used  as  a  pointer  to  the 
beginning  of  the  file  referenced  by  the  FCB. 

FCB + 16  through  FCB  + 19 

This  4-byte  entry  contains  granule  allocation  information  for  an  extent  of  the  file. 
Relative  bytes  0  and  1  contain  the  total  number  of  granules  allocated  to  the  file 
up  to  but  not  including  the  extent  referenced  by  this  field.  Relative  byte  2  con- 
tains the  starting  cylinder  of  this  extent.  Relative  byte  3  contains  the  starting  rel- 
ative granule  for  the  extent  and  the  number  of  contiguous  granules. 

FCB + 20  through  FCB + 23 

Contain  information  similar  to  the  above  but  for  a  second  extent  of  the  file. 

FCB + 24  through  FCB + 27 

Contain  information  similar  to  the  above  but  for  a  third  extent  of  the  file. 

FCB + 28  through  FCB + 31 

Contain  information  similar  to  the  above  but  for  a  fourth  extent  of  the  file. 

The  file  control  block  contains  information  on  only  four  extents  at  one  time.  If 
the  file  has  more  than  four  extents,  additional  directory  accessing  is  done  to 
shift  the  4-byte  entries  in  order  to  make  space  for  the  new  extent  information. 

Although  the  system  can  handle  a  file  of  any  number  of  extents,  you  should 
keep  the  number  of  extents  small.  The  most  efficient  file  is  one  with  a  single 
extent.  The  number  of  extents  can  be  reduced  by  copying  the  file  to  a  disk  that 
contains  a  large  amount  of  free  space. 
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7/TRSDOS  Version  6 
Programming  Guidelines 


Converting  to  TRSDOS  Version  6 


This  section  provides  suggestions  on  writing  programs  effectively  with 
TRSDOS  version  6,  and  on  converting  programs  created  with  TRSDOS  1.3 
and  LDOS  5.1  operating  systems  for  use  with  TRSDOS  Version  6.  This  infor- 
mation is  by  no  means  complete,  but  presents  some  important  concepts  to 
keep  in  mind  when  using  TRSDOS  Version  6. 

When  programming  in  assembly  language,  you  can  use  TRSDOS  Version  6 
routines  for  commonly  used  operations.  These  are  accessed  through  the 
supervisor  calls  (SVCs)  instead  of  absolute  call  addresses.  Nothing  in  the  sys- 
tem can  be  accessed  via  any  absolute  address  reference  (except  Z-80  RST 
and  NMI  jump  vectors). 

IMPORTANT  NOTE:  TRSDOS  provides  all  functions  and  storage  through 
supervisor  calls.  No  address  or  entry  point  below  3000H  is  documented  or  sup- 
ported by  Radio  Shack. 

The  keyboard  is  not  accessible  via  "peeking,"  and  the  video  RAM  cannot  be 
"poked."  The  keyboard  and  video  are  accessible  only  through  the  appropriate 
SVCs. 

Another  distinction  is  that  TRSDOS  Version  6  handling  of  logical  byte  I/O 
devices  (keyboard,  video,  printer,  communications  tine)  completely  supports 
error  status  feedback.  A  FLAG  convention  is  uniform  throughout  these  device 
drivers  as  well  as  physical  byte  I/O  associated  with  files.  The  device  handling 
in  TRSDOS  Version  6  is  completely  independent.  That  means  that  byte  I/O, 
both  logical  and  physical,  can  be  routed,  filtered,  and  linked.  Therefore,  it  is 
important  to  test  status  return  codes  in  all  applications  using  byte  I/O  regard- 
less of  the  device  that  the  application  expects  to  be  used,  since  re-direction  to 
some  other  device  is  possible  at  the  TRSDOS  level.  Appropriate  action  must  be 
taken  when  errors  are  detected. 

Modules  loaded  into  memory  and  protected  by  lowering  HIGH$  must  include 
the  standard  header,  as  described  earlier  under  "Memory  Header."  The 
@GTMOD  supervisor  call  requires  mat  this  header  be  present  in  every  resident 
module  for  proper  operation. 

The  file  password  protection  terms  of  UPDATE  and  ACCESS  have  been 
changed  in  TRSDOS  Version  6  to  OWNER  and  USER,  respectively.  The  addi- 
tional file  protection  level  of  UPDATE  has  been  added.  A  file  with  UPDATE  pro- 
tection level  can  be  read  or  written  to,  but  its  end  of  file  cannot  be  extended. 
This  protection  can  be  useful  in  a  random  access  fixed-size  file  or  in  a  file  where 
shared  access  is  to  take  place. 

Files  opened  with  UPDATE  or  greater  access  are  indicated  as  open  in  their 
directory.  Attempting  to  open  the  file  again  forces  a  change  to  READ  access 
protection  and  a  "File  already  open"  error  code.  It  is  therefore  important  for 
applications  to  CLOSE  files  that  are  opened. 

For  the  convenience  of  applications  that  access  files  only  for  reading,  you  can 
inhibit  the  "file  open  bit."  If  you  set  bit  0  of  the  system  flag  SFLAG$  (see  the 
©FLAGS  supervisor  call),  the  file  open  bit  is  not  set  in  the  file's  directory.  Once 
set,  the  next  @OPEN  or  @INIT  SVC  automatically  resets  bit  0  of  SFLAG$. 
Note  that  you  cannot  use  this  procedure  for  files  being  written  to,  since  it  inhibits 
the  CLOSE  process. 
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Some  application  programs  need  access  to  certain  system  parameters  and 
variables.  A  number  of  flags,  variables,  and  port  images  can  be  accessed  rel- 
ative to  a  flag  pointer  obtained  via  the  ©FLAGS  supervisor  call.  These  param- 
eters are  only  accessible  relative  to  this  pointer,  as  the  pointer's  location  may 
change.  (See  the  explanation  of  the  ©FLAGS  SVC.) 

All  applications  must  honor  the  contents  of  HIGH$.  This  pointer  contains  the 
highest  RAM  address  usable  by  any  program.  You  can  retrieve  and  change 
HIGH$  by  using  the  @HIGH$  SVC. 

TRSDOS  Version  6  library  commands  and  utilities  supply  a  return  code  (RC)  at 
completion.  The  RC  is  returned  in  register  pair  HL.  The  value  returned  is  either 
zero  (indicating  no  error),  a  number  from  one  through  62  (indicating  an  error  as 
noted  in  Appendix  A,  TRSDOS  Error  Messages),  or  X'FFFF'  (indicating  an 
extended  error  which  is  currently  not  assigned  an  error  number).  TRSDOS  Ver- 
sion 6  Job  Control  Language  (JCL)  aborts  on  any  program  terminating  with  a 
non-zero  RC  value.  Applications  should  therefore  properly  set  the  return  code 
register  pair  HL  before  exiting. 

TRSDOS  Version  6  library  commands  are  also  invokable  via  the  @CMNDR 
SVC  which  executes  the  command.  Library  commands  properly  maintain  the 
Stack  Pointer  (SP)  and  exit  via  a  RET  instruction.  In  this  manner,  control  is 
returned  to  the  invoking  program  with  the  RC  present  for  testing.  For  com- 
mands invoked  with  the  ©CMNDI  SVC  or  prompted  for  via  the  ©EXIT  SVC, 
the  SP  is  restored  to  the  system  stack.  The  top  of  the  stack  will  contain  an 
address  suitable  for  simulating  an  ©EXIT  SVC;  thus,  if  your  application  pro- 
gram properly  maintains  the  integrity  of  the  stack  pointer,  it  can  exit  after  setting 
the  RC  via  a  RET  instruction  instead  of  an  ©EXIT  SVC. 

TRSDOS  Version  6  diskette  and  file  structure  is  identical  to  that  used  in  LDOS 
5.1.  This  includes  formatting,  directory  structure,  and  data  address  mark  con- 
ventions. TRSDOS  Version  6  system  diskettes,  however,  use  the  entire  BOOT 
track  (track  0).  This  compatibility  means  that  data  files  may  be  used  inter- 
changeably between  LDOS  5.1  equipped  machines  and  TRSDOS  Version  6 
equipped  machines;  the  diskettes  themselves  are  readable  and  writable  across 
both  operating  systems. 

The  methods  of  internal  handling  of  device  linking  and  filtering  have  been 
changed  from  LDOS  5.1.  (It  is  beyond  the  scope  of  this  manual  to  explain  the 
internal  functioning  of  TRSDOS  Version  6.)  Device  filters  must  adhere  to  a  strict 
protocol  of  linkage  in  order  to  function  properly.  See  the  section  on  "Device 
Driver  and  Filter  Templates"  for  information  on  device  driver  and  filter  protocol. 

Stack  Handling  Restrictions* 

Interrupt  tasks  and  filters  that  deal  with  the  keyboard  or  video  must  not  place 
the  stack  pointer  above  X'F3FF!  This  is  because  any  operation  that  requires  the 
keyboard  or  video  RAM  switches  in  the  3K  bank  at  X'F400'  and  suppresses  the 
stack  until  it  is  switched  out  again.  If  the  system  accesses  the  stack  at  any  time 
during  this  period,  the  integrity  of  the  stack  is  destroyed. 


*ln  TRSDOS  6.0.0,  the  stack  cannot  be  placed  above  X'F3FF*  for  any  reason. 
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Programming  With  Restart  Vectors 


» 
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The  Restart  instruction  (RST)  provides  the  assembly  language  programmer 
with  the  ability  to  call  a  subroutine  with  a  one-byte  call.  If  a  routine  is  called 
many  times  by  a  program,  the  amount  of  space  that  is  saved  by  using  the  RST 
instruction  (instead  of  a  three-byte  CALL)  can  be  significant. 

In  TRSDOS  a  RST  instruction  is  also  used  to  interface  to  the  operating  system. 
The  system  uses  RST  28H  for  supervisor  calls.  RSTS  00H,  30H,  and  38H  are 
for  the  system's  internal  use. 

RSTs  08H,  10H,  18H,  and  20H  are  available  for  your  use.  Caution:  Some  pro- 
grams, such  as  BASIC,  may  use  some  of  these  RSTs. 

Each  RST  instruction  calls  the  address  given  in  the  operand  field  of  the  instruc- 
tion. For  example,  RST  18H  causes  the  system  to  push  the  current  program 
counter  address  onto  the  stack  and  then  set  the  program  counter  to  address 
O018H.  RST  20H  causes  a  jump  to  location  0020H,  and  so  on. 

Each  RST  has  three  bytes  reserved  for  the  subroutine  to  use.  If  the  subroutine 
wili  not  fit  in  three  bytes,  then  you  should  code  a  jump  instruction  (JP)  to  where 
the  subroutine  is  located.  At  the  end  of  the  subroutine,  code  a  return  instruction 
(RET).  Control  is  then  transferred  to  the  instruction  that  follows  the  RST. 

For  example,  suppose  you  want  to  use  RST  18H  to  call  a  subroutine  named 
"ROUTINE."  The  following  routine  loads  the  restart  vector  with  a  jump  instruc- 
tion and  saves  the  old  contents  of  the  restart  vector  for  later  use. 


SETRST: 


LOOP: 


RDATA: 


LD 
LD 
LD 
LD 

LD 

LD 

LD 

INC 

INC 

DJN2 
RET 
DEFB 
DEFW 


IX»0018H 
IY»RDATA 

A>(IX) 

C>(IY) 

(IX) 

(IY) 


,A 


IX 


IY 


LOOP 

0C3H 
ROUTINE 


Restart  area  address 

Data  area  address 

Number  of  bytes  to  move 

Read  a  byte  from 

restart    area 

Read  a  byte  from  data 

area 

Store  this  byte  in 

restart  area 

Store  this  byte  in  data 

area 

Increment  restart  area 

pointer 

Inc  rement 

pointe  r 

Loop  till 


data  area 


moved 


bytes 
Return  when  done 
Jump  instruction  (JP) 
Operand  (name  of 
subroutine ) 


Before  exiting  the  program,  calling  the  above  routine  again  puts  the  original 
contents  of  the  restart  vector  back  in  place. 


KFLAG$  (BREAK).  (PAUSE),  and 
Interfacing 


nana 


» 


KFLAG$  contains  three  bits  associated  with  the  keyboard  functions  of  BREAK, 
PAUSE  (dHEB  (D),  and  ENTER.  A  task  processor  interrupt  routine  (calted  the 
KFLAG$  scanner)  examines  the  physical  keyboard  and  sets  the  appropriate 
KFLAG$  bit  if  any  of  the  conditions  are  observed.  Similarly,  the  RS-232C  driver 
routine  also  sets  the  KFLAG$  bits  if  it  detects  the  matching  conditions  being 
received. 
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Many  applications  need  to  detect  a  PAUSE  or  BREAK  while  they  are  running. 
BASIC  checks  for  these  conditions  after  each  logical  statement  is  executed 
(that  is,  at  the  end  of  aline  or  at  a ":").  That  is  how,  in  BASIC,  you  can  stop  a 
program  with  the  [BREAK)  key  or  pause  a  listing. 

One  method  of  detecting  the  condition  in  previous  TRSDOS  operating  systems 
was  to  issue  the  @KBD  supervisor  call  to  check  for  BREAK  or  PAUSE 
((S3EDGD),  ignoring  all  other  keys.  Unfortunately,  this  caused  keyboard  type- 
ahead  to  be  ineffective;  the  @KBD  SVC  flushed  out  the  type-ahead  buffer  if 
any  other  keystrokes  were  stacked  up. 

Another  method  was  to  scan  the  keyboard,  physically  examining  the  keyboard 
matrix.  An  undesirable  side  effect  of  this  method  was  that  type-ahead  stored  up 
the  keyboard  depression  for  some  future  unexpected  input  request.  Examining 
the  keyboard  directly  also  inhibits  remote  terminals  from  passing  the  BREAK  or 
PAUSE  condition. 

In  TRSDOS  Version  6,  the  KFLAGS  scanner  examines  the  keyboard  for  the 
BREAK,  PAUSE,  and  ENTER  functions.  If  any  of  these  conditions  are  detected, 
appropriate  bits  in  the  KFLAGS  are  set  (bits  0, 1,  and  2  respectively). 

Note  that  the  KFLAG$  scanner  only  sets  the  bits.  It  does  not  reset  them 
because  the  "events"  would  occur  too  fast  for  your  program  to  detect.  Think  of 
the  KFLAGS  bits  as  a  latch.  Once  a  condition  is  detected  (latched),  it  remains 
latched  until  something  examines  the  latch  and  resets  it — a  function  to  be  per- 
formed by  your  KFLAGS  detection  routine. 

Under  Version  6.2,  you  can  use  the  @CKBRKC  SVC,  SVC  106,  to  see  if  the 
BREAK  key  has  been  pressed.  If  a  BREAK  condition  exists,  @CKBRKC  resets 
the  break  bit  of  KFLAGS. 

For  illustration,  the  following  example  routine  uses  the  BREAK  and  PAUSE 
conditions: 


KFLAG* 

EQU 

10 

0FLAGS 

e'qu 

101 

@KBD 

EQU 

8 

SKEY 

EQU 

1 

BPAUSE 

EQU 

16 

CKPAI4S 

LD 

A#@FLAGS 

•Get  Flaas  pointer 

RST 

28H 

iinto  register  IY 

LD 

A,(IY+KFLAG«) 

iGet  the  KFLAG$ 

RRCA 

iBit  0  to  carry 

JP 

C.G0TBRK 

iGo  on  BREAK 

RRCA 

!Bit  1  to  carry 

RET 

NC 

•Return  if  no  pause 

CALL 

RESKFL 

•Reset  the  flad 

PUSH 

DE 

FLUSH 

LD 

A*@KBD 

•Flush  type-ahead 

RST 

28H 

•buffer  while 

JR 

Z, FLUSH 

titfnorind  errors 

POP 

DE 

PROMPT 

PUSH 

DE 

LD 

A  .SKEY 

•Wait  on  Key  entry 

RST 

28H 

POP 

DE 

CP 

80H 

iAbort  on  dBEffi) 

JP 

Z  >GOTBRK 

CP 

60H 

i  I  snore  PAUSE! 

JR 

Z»PROMPT 

ielse  .  .  . 

RESKFL 

PUSH 

HL 

i reset  KFLAG* 

PUSH 

AF 

LD 

A.0FLAGS 

iGet  flatfs  pointer 

RST 

28H 

iinto  register  IY 

RESKFL1 

LD 

Af(IY+KFLAG«) 

iGet  the  fla* 

AND 

0F8H 

•Strip  ENTER* 

0 
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LD  (IY+KFLAG*) .A  SPAUSE.  BREAK 

PUSH  BC 

LD  B.16 

LD  A.@PAUSE       iPause  a  while 

RST  2BH 

POP  BC 

LD  A.UY+KFLAG$)  SCheck  if  finsrer  is 

AND  3  .still  on  Key 

JR  NZ.RESKFL1     .Reset  it  asain 

POP  AF  SRestore  registers 

POP  HL  Sand  exit 

RET 

The  best  way  to  explain  this  KFLAG$  detection  routine  is  to  take  it  apart  and 
discuss  each  subroutine.  The  first  piece  reads  the  KFLAG$  contents: 

KFLAG*      EQU  10 

CKPAWS      LD  A.SFLAGS  »Get    FlaSs    pointer 

RST  28H  Unto    register    IY 

LD  At(IY+KFLAG$)    >Get    the    KFLAG* 

RRCA  .Bit    0    to    carry 

JP  C  .GOTBRK  SGo    on    BREAK 

RRCA  .Bit    1    to    carry 

RET  NC  ?Return    if    no    pause 

The  @FLAGS  SVC  obtains  the  flags  pointer  from  TRSDOS.  Note  that  if  your 
application  uses  the  IY  index  register,  you  should  save  and  restore  it  within  the 
CKPAWS  routine.  (Alternatively,  you  could  use  @FLAGS  to  calculate  the  loca- 
tion of  KFLAG$,  use  register  HL  instead  of  IY,  and  place  the  address  into  the  LD 
instructions  of  CKPAWS  at  the  beginning  of  your  application.) 

The  first  rotate  instruction  places  the  BREAK  bit  into  the  carry  flag.  Thus,  if  a 
BREAK  condition  is  in  effect,  the  subroutine  branches  to  "GOTBRK,"  which  is 
your  BREAK  handling  routine. 

If  there  is  no  BREAK  condition,  the  second  rotate  places  what  was  originally  in 
the  PAUSE  bit  into  the  carry  flag.  If  no  PAUSE  condition  is  in  effect,  the  routine 
returns  to  the  caller. 

This  sequence  of  code  gives  a  higher  priority  to  BREAK  (that  is,  if  both  BREAK 
and  PAUSE  conditions  are  pending,  the  BREAK  condition  has  precedence). 
Note  that  the  GOTBRK  routine  needs  to  clear  the  KFLAG$  bits  after  it  services 
the  BREAK  condition.  This  is  easily  done  via  a  call  to  RESKFL. 

The  next  part  of  the  routine  is  executed  on  a  PAUSE  condition: 

.Reset  the  flas 

FLUSH    LD    A.SKBD         ;Flush  type-ahead 

•buffer  while 
Sidnorind  errors 

First  the  KFLAG$  bits  are  reset  via  the  call  to  RESKFL.  Next,  the  routine  takes 
care  of  the  possibility  that  type-ahead  is  active.  If  it  is,  the  PAUSE  key  was  prob- 
ably detected  by  the  type-ahead  routine  and  so  is  stacked  in  the  type-ahead 
buffer  also.  To  flush  out  (remove  all  stored  characters  from)  the  type-ahead 
buffer,  @KBD  is  called  until  no  characters  remain  (an  NZ  is  returned). 

Now  that  a  PAUSEd  state  exists  and  the  type-ahead  buffer  is  cleared,  the  rou- 
tine waits  for  a  key  input: 

PROMPT       PUSH     DE 


CALL 

RESKFL 

PUSH 

DE 

LD 

A.SKBD 

RST 

2BH 

JR 

Z. FLUSH 

POP 

DE 

LD    A  .©KEY 

Wait  on  Key  entry 

RST   2SH 

POP   DE 

CP    80H 

{Abort  on  ABBOT) 

JP    Z  .GOTBRK 
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CP 

G0H 

5 1  Snore  PAUSE* 

JR 

ZtPROMPT 

5else  t  •  • 

The  PROMPT  routine  accepts  a  BREAK  and  branches  to  your  BREAK  han- 
dling routine.  It  ignores  repeated  PAUSE  (the  60H).  Any  other  character  causes 
it  to  fall  through  to  the  following  routine  which  clears  the  KFLAG$: 


RESKFL   PUSH 
PUSH 
LD 
RST 

RESKFL1  LD 
AND 
LD 

PUSH 
LD 
LD 
RST 
POP 
LD 
AND 
JR 
POP 
POP 
RET 


HL 

AF 

A,  ©FLAGS 

28H 

Af(IY+KFLAG») 

0F8H 

(IY+KFLAG*) »A 

BC 

B.ie 

A.SPAUSE 

28H 

BC 

A >( IY+KFLAG*) 

3 

NZ.RESKFL1 

AF 

HL 


i reset  KFLAG* 

•Get  fla*s  pointer 
!  into  register  IY 
iGet  the  flas 
iStrip  ENTER. 
.PAUSE t    BREAK 


iPause  a  while 


iCheck  if  finder  is 
istill  on  key 
SReset  it  again 
■Restore  registers 
iand  exit 


The  RESKFL  subroutine  should  be  called  when  you  first  enter  your  application. 
This  is  necessary  to  clear  the  flag  bits  that  were  probably  in  a  "set"  condition. 
This  "primes"  the  detection.  The  routine  should  also  be  called  once  a  BREAK, 
PAUSE,  or  ENTER  condition  is  detected  and  handled.  (You  need  to  deal  with 
frie  flag  bits  for  only  the  conditions  you  are  using.) 
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With  the  TRSDOS  library  command  SYSGEN,  many  users  may  wish  to  SYS- 
GEN  the  RS-232C  driver.  Before  doing  that,  the  RS-232C  hardware  (UART, 
Baud  Rate  Generator,  etc.)  must  be  initialized.  Simply  using  the  SYSGEN  com- 
mand with  the  RS-232C  driver  resident  is  not  enough;  some  initialization 
routine  is  necessary.  The  @ICNFG  (Initialization  CoNFiGu ration)  vector  is 
included  in  TRSDOS  to  provide  a  way  to  invoke  a  routine  to  initialize  the  RS- 
232C  driver  when  the  system  is  booted.  It  also  provides  a  way  to  initialize  the 
hard  disk  controller  at  power-up  (required  by  the  Radio  Shack  hard  disk 
system). 

The  final  stages  of  the  booting  process  loads  the  configuration  file  CONFIG/ 
SYS  if  it  exists.  After  the  configuration  file  is  loaded,  an  initialization  subroutine 
CALLs  the  @ICNFG  vector.  Thus,  any  initialization  routine  that  is  part  of  a 
memory  configuration  can  be  invoked  by  chaining  into  @ICNFG. 

If  you  need  to  configure  your  own  routine  that  requires  initialization  at  power-up, 
you  can  chain  into  @ICNFG.  The  following  procedure  illustrates  this  link.  The 
first  thing  to  do  is  to  move  the  contents  of  the  @ICNFG  vector  into  your  initiali- 
zation routine: 


LD  A*@FLAGS 

RST  28H 

LD  A»(IY+28) 

LD  <LINK)»A 

LD  L#(IY+29) 

LD  H»(IY+30) 

LD  (LINK+D.HL 


iGet  flaffs  pointer 
Jinto  register  IY 
5Get  opcode 

iGet  address  LOW 
iGet  address  HIGH 


This  subroutine  does  this  by  transferring  the  3-byte  vector  to  your  routine.  You 
then  need  to  relocate  your  routine  to  its  execution  memory  address.  Once  this 


® 
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LD 

HLtlNIT 

LD 

(IY+29) »L 

LD 

(IY+30) #H 

LD 

A»0C3H 

LD 

(IY+2B)  -A 

» 


is  done,  transfer  the  relocated  initialization  entry  point  to  the  @ICNFG  vector  as 
a  jump  instruction: 

•Get  (relocated) 
5init  address 

jSet  JP  instruction 

If  you  need  to  invoke  the  initialization  routine  at  this  point,  then  you  can  use: 

CALL     ROUTINE  Unvoke    your    routine 

Your  initialization  routine  would  be  unique  to  the  function  it  was  to  perform,  but 
an  overall  design  would  look  like  this: 

INIT     CALL  ROUTINE        iStart  of  init 

LINK     DEFS  3  .Continue  on 

ROUTINE  • 

your  initialization  routine 

RET 

After  linking  in  your  routine,  perform  the  SYSGEN.  If  you  have  followed  these 
procedures,  your  routine  will  be  invoked  every  time  you  start  up  TRSDOS. 


Interfacing  to  @KTTSK 


START 

CALL 

ROUTINE 

LINK 

DEFS 

3 

ROUTINE 

EOU 

* 

• 


Background  tasks  can  be  invoked  in  one  of  two  ways.  For  tasks  that  do  not 
require  disk  I/O,  you  can  use  the  RTC  (Real  Time  Clock)  interrupt  and  one  of 
the  12  task  slots  (or  other  external  interrupt).  For  tasks  that  require  disk  I/O,  you 
can  use  the  keyboard  task  process. 

At  the  beginning  of  the  TRSDOS  keyboard  driver  is  a  call  to  @K!TSK.  This 
means  that  any  time  that  @KBD  is  called,  the  @KITSK  vector  is  also  called. 
(The  type-ahead  task,  however,  bypasses  this  entry  so  that  @KITSK  is  not 
called  from  the  type-ahead  routine.)  Therefore,  if  you  want  to  interface  a  back- 
ground routine  that  does  disk  I/O,  you  must  chain  into  @KITSK. 

The  interfacing  procedure  to  @KITSK  is  identical  to  that  shown  in  the  section 
"Interfacing  to  @ICNFG,"  except  that  IY+31  through  IY+33  is  used  to  refer- 
ence the  @KITSK  vector.  You  may  want  to  start  your  background  routine  with: 

ilnuoke  task 
•For  SKITSK  hooK 
•Start  of  the  task 

Be  aware  of  one  major  pitfall.  The  @KBD  routine  is  invoked  from  @CMNDI  and 
@CMNDR  (which  is  in  SYS1/SYS).  This  invocation  is  from  the  @KEYIN  call, 
which  fetches  the  next  command  line  after  issuing  the  "TRSDOS  Ready"  mes- 
sage. If  your  background  task  executes  and  opens  or  closes  a  file  (or  does  any- 
thing to  cause  the  execution  of  a  system  overlay  other  than  SYS1 ),  then  SYS1 
is  overwritten  by  SYS2  or  SYS3.  When  your  routine  finishes,  the  @KEYIN  han- 
dler tries  to  return  to  what  called  it — SYS1,  which  is  no  longer  resident.  There- 
fore, any  task  chained  to  @KITSK  which  causes  a  resident  SYS1  to  be  over- 
written must  reload  SYS1  before  returning. 

You  can  use  the  following  code  to  reload  SYS1  if  SYS1  was  resident  prior  to 
your  task's  execution: 

iGet    flatfs    pointer 
iinto    register    IY 
!Get    resident    over- 
Slay    and    remove 
ithe    entry    code 
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ROUTINE  LD 

A  *@FLAGS 

RST 

28H 

LD 

At(IY-l) 

AND 

8FH 

LD 

(0LDSYS+1) ,A 

rest  of  your  tasK 


EXIT 

ECU 

$ 

OLDSYS 

LD 

A»0 

CP 

B3H 

RET 

NZ 

RST 

28H 

SGet  old  overlay  * 
;Was  it  SYS1? 
{Return  if  not!  else 
»Get  SYS1  per  red.  A 
!(no  RET  needed) 


Interfacing  to  the  Task  Processor 


This  section  explains  how  to  integrate  interrupt  tasks  into  your  applications. 

One  of  the  hardware  interrupts  in  the  TRS-80  is  the  real  time  clock  (RTC).  The 
RTC  is  synchronized  to  the  AC  line  frequency  and  pulses  at  60  pulses  per  sec- 
ond, or  once  every  16.67  milliseconds.  (Computers  operating  with  50  Hz  AC 
use  a  50  pulses  per  second  RTC  interrupt.  In  this  case,  all  time  relationships 
discussed  in  this  section  should  be  adjusted  to  the  50  Hz  base.) 

A  software  task  processor  manages  the  RTC  interrupt  in  performing  back- 
ground tasks  necessary  to  specific  functions  of  TRSDOS  (such  as  the  time 
clock,  blinking  cursor,  and  so  on).  The  task  processor  allows  up  to  12  individual 
tasks  to  be  performed  on  a  "time-sharing"  basis. 

These  tasks  are  assigned  to  "task  slots"  numbered  from  0  to  11.  Slots  0-7  are 
considered  "low  priority"  tasks  (executing  every  266.67  milliseconds).  Slots  8- 
10  are  medium  priority  tasks  (executing  every  33.33  milliseconds).  Slot  11  is  a 
high  priority  task  (executing  every  16.66  milliseconds  SYSTEM  (FAST)  or  33.33 
milliseconds  SYSTEM  (SLOW)).  Task  slots  3, 7, 9,  and  10  are  reserved  by  the 
system  for  the  ALIVE,  TRACE,  SPOOL,  and  TYPE-AHEAD  functions, 
respectively. 

TRSDOS  maintains  a  Task  Control  Block  Vector  Table  (TCBVT)  which  contains 
12  vectors,  one  for  each  of  the  12  task  slots.  TRSDOS  contains  five  supervisor 
calls  that  manage  the  task  vectors.  The  five  SVCs  and  their  functions  are: 

@CKTSK  Checks  to  see  whether  a  task  slot  is  unused  or  active 

@ADTSK  Adds  a  task  to  the  TCBVT 

@RMTSK  Removes  a  task  from  the  TCBVT 

@KLTSK  Removes  the  currently  executing  task 

@RPTSK  Replaces  the  TCB  address  for  the  current  task 

The  TRSDOS  Task  Control  Block  Vector  Table  contains  vector  pointers.  Each 
TCBVT  vector  points  to  an  address  in  memory,  which  in  turn  contains  the 
address  of  the  task.  Thus,  the  tasks  themselves  are  indirectly  addressed. 

When  you  are  programming  a  task  to  be  called  by  the  task  processor,  the  entry 
point  of  the  routine  needs  to  be  stored  in  memory.  If  you  make  this  storage  loca- 
tion the  beginning  of  a  Task  Control  Block  (TCB),  the  reason  for  indirect  vector- 
ing of  interrupt  tasks  will  become  more  clear.  Consider  an  example  TCB: 

MYTCB  DEFW  MYTASK 

COUNTER  DEFB  15 

TEMPY  DEFS  1 

MYTASK  RET 

This  is  a  useless  task,  since  the  only  thing  it  does  is  return  from  the  interrupt. 
However,  note  that  a  TCB  location  has  been  defined  as  "MYTCB"  and  that  this 
location  contains  the  address  of  the  task.  A  few  more  data  bytes  immediately 
following  the  task  address  storage  have  also  been  defined. 

Upon  entry  to  a  service  routine,  index  register  IX  contains  the  address  of  the 
TCB.  You  can  therefore  address  any  TCB  data  using  index  instructions.  For 
example,  you  could  use  the  instruction  "DEC  (IX +2)"  to  decrement  the  value 
contained  in  COUNTER  in  the  above  routine. 
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Here  is  the  routine  expanded  slightly: 


MYTCB 

DEFW 

MYTASK 

COUNTER 

DEFB 

15 

TEMPY 

DEFB 

0 

MYTASK 

DEC 

(IX+2) 

RET 

NZ 

LD 

(IX+2) #15 

RET 

This  version  makes  use  of  the  counter.  Each  time  the  task  executes,  the  counter 
is  decremented.  When  the  count  reaches  zero,  the  counter  is  restored  to  its 
original  value. 

In  order  to  be  executed,  all  tasks  must  be  added  to  the  TCBVT.  The  @ADTSK 
supervisor  call  does  this.  For  the  above  routine,  assume  the  task  slot  chosen  is 
low-priority  slot  2.  You  can  ascertain  that  slot  2  is  available  for  use  by  using  the 
@CKTSK  SVC  as  follows: 

•Reference    slot    2 

•  Set  for  BCKTSK  SVC 

•  An  "NZ"  indication 

•  says  that  the  slot  is 
ibein?  used. 

Once  you  determine  that  the  slot  is  available  (that  is,  not  being  used  by  some 
other  task),  you  can  add  your  task  routine.  The  following  code  adds  this  task  to 
the  TCBVT: 


LO 

C»2 

LD 

A  ,28 

RST 

28H 

JP 

NZfINUSE 

LD  DE, MYTCB 

LD  C.2 

LD  A  ,29 

RST  28H 


iPoint  to  the  TCB 
•Reference  slot  2 
iSet  for  SADTSK  SVC 
•Issue  the  SVC 


The  above  program  lines  point  register  DE  to  the  TCB,  load  the  task  slot  num- 
ber into  register  C,  and  then  issue  the  @ADTSK  supervisor  call.  If  you  want  this 
task  to  run  regardless  of  what  is  in  memory,  you  can  place  it  in  high  memory  (of 
bank  0)  and  protect  it  by  moving  HIGH$  below  it  via  the  @HIGH$  supervisor 
call. 

Once  a  task  has  been  activated,  it  is  sometimes  necessary  to  deactivate  it.  You 
can  do  this  in  two  ways.  The  most  common  way  is  to  use  the  @RMTSK  super- 
visor call: 


LD 

C.2 

•Designate  the  task 
•  slot 

LD 

A  ,30 

•Set  for  0RMTSK  SVC 

RST 

28H 

;issue  the  SVC 

You  identify  the  task  slot  to  remove  by  placing  a  value  in  register  C,  and  then 
you  issue  the  supervisor  call. 

You  can  use  another  method  if  you  want  to  remove  the  task  while  it  is  being 
executed.  Examine  the  routine  modified  as  follows: 


MYTCB 

DEFW 

MYTASK 

COUNTER 

DEFB 

10 

TEMPY 

DEFB 

0 

MYTASK 

DEC 

(IX+2) 

RET 

NZ 

LD 

A  .32 

;Set  for  ©KLTSK 

RST 

28H 

•Issue  the  SVC 

SVC 


The  @KLTSK  supervisor  call  removes  the  currently  executing  task  from  the 
TCBVT.  The  system  does  not  return  to  your  routine,  but  continues  as  if  you  had 
executed  a  RET  instruction.  For  this  reason,  the  @KLTSK  SVC  should  be  the 
last  instruction  you  want  executed.  In  this  example,  MYTASK  decrements  the 
counter  by  one  on  each  entry  to  the  task.  When  the  counter  reaches  zero,  the 
task  is  removed  from  slot  2. 
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The  last  task  processor  supervisor  call  is  @RPTSK.  The  @RPTSK  function 
updates  the  TCB  storage  vector  (the  vector  address  in  your  Task  Control  Block) 
to  be  the  address  immediately  following  the  @RPTSK  SVC  instruction.  As  with 
@KLTSK,  the  system  does  not  return  to  your  service  routine  after  the  SVC  is 
made,  but  continues  on  with  the  task  processor.  The  following  example  illus- 
trates how  @RPTSK  can  be  used  in  a  program: 


SADTSK 

SRPTSK 

6RMTSK 

SEXIT 

BVDCTL 

BEGIN 


TCB 

COUNTER 

TASKA 

TASK 


TASKB 


ORG 

EOU 

EOU 

EOU 

EOU 

EOU 

LD 

LO 

LD 

RST 

LD 

RST 

DEFW 

DEFB 

LD 

RST 

LD 

LD 

LD 

RST 

DEC 

RET 

LD 

LD 

RST 

LD 

LD 

LD 

RST 

DEC 

RET 

LD 

JR 

END 


9000H 

29 

31 

30 

22 

15 

DE.TCB 

C.0 

A.6ADTSK 

28H 

A. ©EXIT 

28H 

TASK 

15 

A.6RPTSK 

28H 

BC.027CH 

HL.004FH 

A.BVDCTL 

28H 

(IX+2) 

NZ 

(IX+2)  .15 

A  .SRPTSK 

28H 

BC.022DH 

HL  .004FH 

A.eUDCTL 

28H 

(IX+2> 

NZ 

(IX+2)  .15 

TASKA 

BEGIN 


iPoint  to  TCB 
»and  add  the  task 
!to  slot  0 

jExit  to  TRSDOS 


SReplace  current 
itasK  with  TASKA 
5Put  a  character 
iat  Row  0.  Col.  79 


{Decrement  the  counter 
!and  return  if  not 
texpiredi  else  reset 
{Replace  the  previous 
itasK  with  TASKB 
;Put  a  character 
tat  Row  0*  Col.  79 


This  task  routine  contains  no  method  of  relocating  it  to  protected  RAM.  The 
statements  starting  at  the  label  BEGIN  add  the  task  to  TCBVT  slot  0  and  return 
to  TRSDOS  Ready.  The  task  contains  a  four-second  down  counter  and  a  rou- 
tine to  put  a  character  in  video  RAM  (80th  character  of  Row  0).  At  four-second 
intervals,  the  character  toggles  between  '!'  and  '- :  This  is  done  by  using  the 
@RPTSK  SVC  to  toggle  the  execution  of  two  separate  routines  which  perform 
the  character  display. 

TRSDOS  uses  bank-switched  memory.  In  order  to  properly  control  and  man- 
age this  additional  memory,  certain  restrictions  are  placed  on  tasks.  All  tasks 
must  be  placed  either  in  low  memory  (addresses  X'OOOO'  through  X7FFF')  or 
in  bank  zero  of  high  memory  (addresses  X'8000'  through  X'FFFF").  The  task 
processor  always  enables  bank  zero  when  performing  background  tasks.  The 
assembly  language  programmer  must  ensure  that  tasks  are  placed  in  the  cor- 
rect memory  area. 


Interfacing  RAM  Banks  1  and  2 


The  proper  use  of  the  RAM  bank  transfer  techniques  described  here  requires  a 
high  degree  of  skill  in  assembly  language  programming.  This  section  on  bank 
switching  is  intended  for  the  professional. 
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The  TRS-80  Model  4  can  optionally  support  a  second  set  of  64K  RAM,  bringing 
the  total  RAM  to  128K.  TRSDOS  designates  this  extra  64K  RAM  as  two  banks 
of  32K  RAM  each,  which  are  banks  1  and  2  of  bank-switched  RAM.  The  upper 
32K  of  standard  RAM  is  designated  bank  0.  At  any  one  time,  only  one  of  the 
banks  is  resident.  The  resident  bank  is  always  addressed  at  X'8000'  through 
X'FFFF.'  When  a  bank  transfer  is  performed,  the  specified  bank  becomes 
addressable  and  the  previous  bank  is  no  longer  available.  Since  memory 
refresh  is  performed  on  all  banks  at  all  times,  nothing  in  the  previously  resident 
bank  is  altered  during  whatever  time  it  is  not  addressable  (that  is,  not  resident). 

You  can  access  this  additional  RAM  by  means  of  the  @BANK  supervisor  call 
(SVC  102).  When  you  power  up  your  computer  or  press  reset,  TRSDOS  looks 
to  see  which  banks  of  RAM  are  installed  in  your  machine.  TRSDOS  maintains 
a  bit  map  in  one  byte  of  storage,  with  each  bit  representing  one  of  the  banks  of 
RAM.  This  byte  is  called  "Bank  Available  RAM"  (BAR),  and  its  information  is  set 
when  you  boot  TRSDOS.  Bit  0  corresponds  to  bank  0,  bit  1  corresponds  to 
bank  1,  and  so  on  up  to  bit  7.  From  a  hardware  standpoint,  the  Model  4  has  a 
maximum  of  three  banks.  You  have  either  bank  0  only  (a  64K  machine),  or 
banks  0-2  (a  128K  machine). 

Another  bit  map  is  used  to  indicate  whether  a  bank  is  reserved  or  available  for 
use.  This  byte  is  called  the  "Bank  Used  RAM"  (BUR).  Again,  bit  0  corresponds 
to  bank  0,  bit  1  to  bank  1,  and  so  on.  TRSDOS  design  supports  the  use  of  banks 
1  and  2  primarily  for  data  storage  (for  example,  a  spool  buffer,  Memdisk,  etc.). 
The  management  of  any  memory  space  within  a  particular  bank  of  RAM 
(excluding  bank  0)  is  the  responsibility  of  the  application  program  "reserving"  a 
particular  bank. 

TRSDOS  requires  that  any  device  driver  or  filter  that  is  relocated  to  high  mem- 
ory (X'8000'  through  X'FFFF')  reside  in  bank  0.  The  TRSDOS  device  handler 
always  invokes  bank  0  upon  execution  of  any  byte  I/O  service  request  (@PUT, 
@GET,  @CTL,  as  well  as  other  byte  I/O  SVCs  that  use  @PUT/@GET/@CTL). 
This  ensures  that  any  filter  or  driver  attached  to  the  device  in  question  will  be 
available.  If  a  RAM  bank  other  than  0  was  resident,  it  is  restored  upon  return 
from  the  device  handler.  This  ensures  that  device  I/O  is  never  impacted  by  bank 
switching. 

TRSDOS  also  requires  that  all  interrupt  tasks  reside  in  bank  0  or  low  memory 
(X'0000'  through  X7FFF).  The  interrupt  task  processor  always  enables  bank  0 
and  restores  whatever  bank  was  previously  resident.  An  interrupt  task  may  per- 
form a  bank  transfer  from  0  to  another  bank  provided  the  necessary  linkage 
and  stack  area  is  used.  This  is  discussed  in  more  detail  later. 

AH  bank  transfer  requests  must  be  performed  using  the  @BANK  SVC.  This 
SVC  provides  four  functions,  three  of  which  are  interrogatory  and  one  of  which 
performs  the  actual  bank  switching. 

As  mentioned  previously,  the  contents  of  banks  other  than  0  are  managed  by 
the  application,  not  by  TRSDOS.  Therefore,  the  application  needs  a  way  of  find- 
ing out  if  any  given  bank  is  available.  For  example,  if  an  application  wants  to 
reserve  use  of  bank  1,  it  must  first  check  to  see  if  bank  1  is  free  to  use.  This  is 
done  by  using  function  2  as  follows: 

(Specify  bank  1 

SCheck  BUR  if  bank  in  use 

!Set  ©BANK  SVC  (102) 

»NZ    if    bank    already    in    use 

Note  that  the  return  condition  (NZ  or  Z)  shows  whether  or  not  you  can  use  the 
specified  bank  (it  may  not  even  be  installed). 

If  the  specified  bank  is  available,  you  then  need  to  reserve  it.  Do  this  by  using 
function  3  as  follows: 


in    use' 


LD 

C»l 

L0 

B,2 

LD 

AtSBANK 

RST 

28H 

JR 

NZtlNUSE 

LD 

C,l 

•Specify  bank  1 

LD 

B»3 

iSet  BUR  to  show 
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LD 

A  .8BANK 

RST 

2BH 

JR 

NZ  .ERROR 

SSet    0BANK    SVC    (102) 


You  must  check  for  an  error  by  examining  the  Z  flag.  In  general  (discounting  a 
system  error),  an  NZ  condition  returned  means  that  the  specified  bank  is 
already  in  use.  If  you  had  performed  a  function  2  (testing  to  see  if  the  bank  was 
available)  and  got  a  not-in-use  indication,  but  got  an  NZ  condition  on  function 
3,  then  the  ©BANK  SVC  routine  has  been  altered  and  is  probably  unusable. 

When  an  application  no  longer  requires  a  memory  bank,  it  can  return  the  bank 
to  a  "free"  state  by  using  function  1  as  follows: 


LD 

C.l 

iSpecify  bank  1 

LD 

B,l 

iSet  BUR  to  show  free 

LD 

A  .SBANK 

SSet  0BANK  SVC  (102) 

RST 

28H 

LD 

B,a 

LD 

AtSBANK 

RST 

28H 

No  error  condition  is  checked,  as  none  is  returned  by  TRSDOS.  If  you  should 
mistakenly  use  function  1  with  a  bank  that  is  nonexistent,  an  error  is  returned  if 
you  try  to  invoke  the  nonexistent  bank. 

To  find  out  which  bank  is  resident  at  any  time,  use  function  4  as  follows: 

•Which  bank  is  resident? 
iSet  ©BANK  SVC  (102) 

The  current  bank  number  is  returned  in  register  A. 

To  exchange  the  current  bank  with  the  specified  bank,  use  function  0.  Since  a 
memory  transfer  takes  place  in  the  address  range  X'8000'  through  X'FFFF,' 
the  transfer  cannot  proceed  correctly  if  the  stack  pointer  (SP)  contains  a  value 
that  places  the  stack  in  that  range.  @BANK  inhibits  function  0  and  returns  an 
SVC  error  if  the  stack  pointer  violates  this  condition. 

A  bank  can  be  used  purely  as  a  data  storage  buffer.  The  application's  routines 
for  invoking  and  indexing  the  bank  switching  probably  reside  in  the  user  range 
X'3000'  through  X7FFF.'  As  an  example,  the  following  code  invokes  a  previ- 
ously tested  and  reserved  bank  (via  functions  2  and  3),  accesses  the  buffer, 
and  then  restores  the  previous  bank: 

LD  C»l  {Specify  bank  1 

LD  B»0  tBrinS  up  bank 

LD  A, ©BANK  ;Set  BBANK  SVC  (102) 

RST  28H 

JR  NZ»ERROR  ;Error  trap 

PUSH  BC  iSave  old  bank  data 

» 

your  code  to  access  the  buffer  region 

« 

POP  BC  {Recover  old  bank  data 

LD  A.8BANK  SSet  6BANK  SVC  (102) 

RST  28H 

JR  NZ  .ERROR  iError  trap 

Note  that  the  @BANK  function  0  conveniently  returns  a  zero  in  register  B  to 
effect  a  function  0  later,  as  well  as  provides  the  old  bank  number  in  register  C. 
This  means  that  you  only  have  to  save  register  pair  BC,  pop  it  when  you  want 
to  restore  the  previous  bank,  and  then  issue  the  @BANK  SVC. 

Suppose  you  want  to  transfer  to  another  bank  from  a  routine  that  is  executing 
in  high  memory.  (Recall  that  the  only  limitation  is  that  the  stack  must  not  be  in 
high  memory.)  The  ©BANK  SVC  function  0  provides  a  technique  for  automat- 
ically transferring  to  an  address  in  the  new  bank.  This  technique  is  called  the 
transfer  function.  It  relies  on  the  assumption  that  since  you  are  managing  the 
entire  32K  bank  1  or  2,  your  application  should  know  exactly  where  it  needs  to 
transfer  (that  is,  where  the  application  originally  placed  the  code  to  execute). 
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The  code  to  perform  a  bank  transfer  is  similar  to  the  above  example.  Register 
pair  HL  is  loaded  with  the  transfer  address.  Register  C,  which  contains  the  num- 
ber of  the  bank  to  invoke,  must  have  its  high  order  bit  {bit  7)  set.  After  the  spec- 
ified bank  is  enabled,  control  is  passed  to  the  transfer  address  that  is  in  HL. 
Upon  entry  to  your  routine  in  the  new  bank  (referred  to  here  as  "PROGB"),  reg- 
ister HL  will  contain  the  old  return  address  so  that  PROGB  wil!  know  where  to 
return  transfer.  Register  C  will  also  contain  the  old  bank  number  with  bit  7  set 
and  register  B  will  contain  a  zero.  This  register  set-up  provides  for  an  easy 
return  to  the  routine  in  the  old  bank  that  invoked  the  bank  transfer.  An  illustra- 
tion of  the  transfer  code  follows: 


LD 

C.l 

•Specify  bank  1 

LD 

B,0 

!Brin*  up  bank  0 

LD 

HL>CTRAADR) 

iSet  the  transfer 
iaddress 

SET 

7#C 

iand  denote  a 
5t  ransf er 

LD 

A  *SBANK 

SSet  ©BANK  SVC  (102) 

RST 

Z8H 

JR 

NZ  .ERROR 

Control  is  returned  to  "RETADR"  under  either  of  two  conditions.  If  there  was  an 
error  in  executing  the  bank  transfer  (for  example,  if  an  invalid  bank  number  was 
specified  or  the  stack  pointer  is  in  high  memory),  the  returned  condition  is  NZ. 
If  the  transfer  took  place  and  PROGB  transferred  back,  the  returned  condition 
is  Z.  Thus,  the  Z  flag  shows  whether  or  not  there  was  a  problem  with  the 
transfer. 

If  PROGB  needs  to  provide  a  return  code,  it  must  be  done  by  using  register  pair 
DE,  IX,  or  IY,  as  registers  AR  BC,  and  HL  are  used  to  perform  the  transfer.  (Or, 
some  other  technique  can  be  used,  such  as  altering  the  return  transfer  address 
to  a  known  error  trapping  routine.) 

PROGB  should  contain  code  that  is  similar  to  that  shown  earlier.  For  example, 
PROGB  could  be: 

PROGB     PUSH    BC  iSave  old  bank  data 

PUSH   HL  JSaue  the  RET 


iaddress 


your    PROGB    routines 


POP  HL  .Recover    transfer 

.add ress 

POP    BC  iGet  bank  transfer 

idata 

LD      A»102         .Set  ©BANK  SVC 

RST     28H 

JR  NZtERROR  iError    trap 

PROGB  saves  the  bank  data  (register  BC).  Don't  forget  that  a  transfer  was 
effected  and  register  C  has  bit  7  already  set  when  PROGB  is  entered.  PROGB 
also  saves  the  address  it  needs  to  transfer  back  (which  is  in  HL).  It  then  per- 
forms whatever  routines  it  has  been  coded  for,  recovers  the  transfer  data,  and 
issues  the  bank  transfer  request.  As  explained  earlier,  an  NZ  return  condition 
from  the  ©BANK  SVC  indicates  that  the  bank  transfer  was  not  performed.  You 
should  verify  that  your  application  has  not  violated  the  integrity  of  the  stack 
where  the  transfer  data  was  stored. 

Never  place  disk  drivers,  device  drivers,  device  filters,  or  interrupt  service  rou- 
tines in  banks  other  than  bank  0.  It  is  possible  to  segment  one  of  the  above 
modules  and  place  segments  in  bank  1  or  2,  provided  the  segment  containing 
the  primary  entry  is  placed  in  bank  0.  You  can  transfer  between  segments  by 
using  the  bank  transfer  techniques  discussed  above. 
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Device  Driver  and  Filter  Templates 


Device  independence  has  its  roots  in  "byte  I/O."  Byte  I/O  is  any  I/O  passed 
through  a  device  channel  one  byte  at  a  time. 

Three  primitive  routines  are  available  at  the  assembly  language  level  for  byte 
I/O.  These  byte  I/O  primitives  can  be  used  to  build  larger  routines.  The  three 
primitives  are  the  TRSDOS  supervisor  calls  @GET,  @PUT,  and  @CTL  @GET 
is  used  to  input  a  byte  from  a  device  or  file.  @PUT  is  used  to  output  a  byte  to  a 
device  or  file.  @CTL  is  used  to  communicate  with  the  driver  routine  servicing 
the  device  or  file. 

Other  supervisor  calls  perform  byte  I/O,  such  as  @KBD  (scan  the  keyboard  and 
return  the  key  code  if  a  key  is  down),  @DSP  (display  a  character  on  the  video 
screen),  and  @PRT  (output  a  character  to  the  line  printer).  These  functions 
operate  by  first  loading  register  pair  DE  with  a  pointer  to  a  specific  Device  Con- 
trol Block  (DCB)  assigned  for  use  by  the  device,  then  issuing  a  @GET  or 
@PUT  SVC  for  input  or  output  requests. 

When  TRSDOS  passes  control  over  to  the  device  driver  routine,  the  Z-80  flag 
conditions  are  unique  for  each  different  primitive.  This  enables  the  driver  to 
establish  which  primitive  was  used  to  access  the  routine,  so  it  can  turn  over  the 
I/O  request  to  the  proper  driver  or  filter  subroutine  according  to  the  type  of 
request — input,  output,  or  control. 

The  following  table  shows  the  FLAG  register  conditions  upon  entry  to  a  driver 
or  filter: 

C,NZ  =@GET  primitive 
Z,NC  =  @PUT  primitive 
NZ.NC  =  @CTL  primitive 

Register  B  contains  the  I/O  direction  code:  1  =@GET,  2  =  @PUT,  4  =  @CTL. 
Register  C  contains  the  character  code  that  was  passed  in  the  @PUT  or  @CTL 
supervisor  call.  Register  IX  points  to  the  TYPE  byte  (DCB  +  0)  of  the  Device 
Control  Block.  Registers  BC,  DE,  HL,  and  IX  have  been  saved  on  the  stack  and 
are  available  for  use.  Register  AF  is  not  saved;  if  you  want  it  preserved,  your 
program  must  do  so. 

Your  driver  must  start  with  a  standard  front-end  header  (see  "Memory 
Header"): 

BEGIN     JR     START        »Go  to  actual  code 

ibesinnins 
DEFW    MODEND-1      iLast  byte  used  by 

5 module 
DEFB    7  SLenSth  of  name 

DEFM    'MODNAME'     iName 
MODDCB    DEFM    *-$  iOCB  ptr.  for  this 

» module 
DEFW    0  .Reserved  by  TRSDOS 

At  the  start  of  the  actual  module  code,  test  the  condition  of  the  F  register  flags 
for  @GET,  @PUT,  and  @CTL: 

START     EOU     $ 

i        Actual  module  code  start 

JR  C.WASGET  ;Go  if  ©GET  request 
JR  Z.WASPUT  ;Go  if  @PUT  request 
♦  JWas  SCTL  request 

At  the  label  START,  a  test  is  made  on  the  carry  flag.  If  the  carry  was  set,  then 
the  disk  primitive  must  have  been  an  input  request  (@GET).  An  input  request 
could  be  directed  to  a  part  of  the  driver  which  only  handles  input  from  the 
device. 


("0 
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If  the  request  was  not  from  the  @GET  primitive,  the  carry  will  not  be  set.  The 
next  test  checks  to  see  if  the  zero  flag  is  set.  The  zero  condition  is  preset  when 
a  @PUT  primitive  was  the  Initial  request.  The  jump  to  WASPUT  can  go  to  a  part 
of  the  driver  that  deals  specifically  with  output  to  the  device. 

If  neither  the  zero  nor  carry  flags  are  set,  the  routine  falls  through  to  the  next 
instruction  (not  shown),  which  would  begin  the  part  of  the  driver  that  handles 
@CTL  calls.  For  example,  you  may  want  to  have  an  RS-232C  driver  handle  a 
BREAK  by  issuing  a  @CTL  call  so  that  the  RS-232C  driver  emits  a  true  modem 
break,  but  a  CONTROL  C  would  @PUT  a  X'Oa' 

Some  drivers  are  written  to  assume  that  @CTL  requests  are  to  be  handled 
exactly  like  @PUT  requests.  This  is  entirely  up  to  the  author  and  the  function  of 
the  driver. 

Note  that  when  a  device  is  routed  to  a  disk  file,  TRSDOS  ignores  @CTL 
requests.  That  is,  the  @CTL  codes  are  not  written  to  the  disk  file. 

On  @GET  requests,  the  character  input  should  be  placed  in  the  accumulator. 
On  output  requests  (either  @PUT  or  @CTL),  the  character  is  obtained  from 
register  C.  It  is  important  for  drivers  and  filters  to  observe  return  codes.  Specif- 
ically, if  the  request  is  @GET  and  no  byte  is  available,  the  driver  returns  an  NZ 
condition  and  the  accumulator  Contains  a  zero  (that  is,  OR  1 :  LD  A,0 :  RET).  If 
a  byte  is  available,  the  byte  is  placed  in  the  accumulator  and  the  Z  fiag  is  set 
(that  is,  LD  A.CHAR  :  CP  A  :  RET).  If  there  is  an  input  error,  the  error  code  is 
returned  in  the  accumulator  and  the  Zflag  is  reset  (that  is,  LD  A.ERRNUM  :  OR 
A :  RET).  On  output  requests,  the  accumulator  will  contain  the  byte  output  with 
the  Z  fiag  set  if  no  error  occurred.  In  the  case  of  an  output  error,  the  accumulator 
must  be  loaded  with  the  error  code  and  the  Z  flag  reset  as  shown  above. 

A  filter  module  is  inserted  between  the  DCB  and  driver  routine  (or  between  the 
DCB  and  the  current  filter  when  it  is  applied  to  a  DCB  already  filtered).  The 
insertion  is  performed  by  the  TRSDOS  FILTER  command  once  the  filter  mod- 
ule is  resident  and  attached  to  a  phantom  DCB.  The  usual  linkage  for  a  filter  is 
to  access  the  chained  module  by  calling  the  @CHNIO  supervisor  call  with  spe- 
cific linkage  data  in  registers  IX  and  BO  Register  IX  is  loaded  with  the  filter's 
DCB  pointer  obtained  from  the  memory  header  MODDCB  pointer.  Register  B 
must  contain  the  I/O  direction  code  (1  =@GET,  2  =  @PUT,  4  =  @CTL).  This 
code  is  already  in  register  B  when  the  filter  is  entered.  You  can  either  keep  reg- 
ister B  undisturbed  or  load  it  with  the  proper  direction  code.  Also,  output 
requests  expect  the  output  byte  to  be  in  register  C. 

The  DCB  pointer  obtained  from  MODDCB  is  passed  in  register  DE  by  the  SET 
command  and  is  loaded  into  MODDCB  by  your  filter  initialization  routine.  The 
initialization  routine  needs  to  relocate  the  filter  to  high  memory  and  attach  itself 
to  the  DCB  assigned  by  the  SET  command.  If  the  initialization  front  end  had 
transferred  the  DCB  pointer  from  DE  to  IX,  then  the  following  code  could  be 
used  to  establish  the  TYPE  byte  and  vector  for  the  filter: 

LD     <IX)#47H       SInit  DCB  type  to 
LD      (IX+i)tE        IFILTER,  G/P/C  I/Oi 
LD      (IX+2)»D       i&  stuff  vector 

A  filter  module  can  operate  on  input,  output,  control,  or  any  combination  based 
on  the  author's  design.  The  memory  header  provides  a  region  for  user  data 
storage  conveniently  indexed  by  the  module. 

An  illustration  of  a  filter  follows.  The  purpose  of  this  filter  is  to  add  a  linefeed  on 
output  whenever  a  carriage  return  is  to  be  sent.  Although  the  filter  requires  no 
data  storage,  the  technique  for  accessing  data  storage  is  shown. 
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The  relocation  table,  RELTAB,  would  be  used  by  the  filter  initialization  relocation 
routine. 


@CTL  Interfacing  to  Device  Drivers 


This  section  discusses  the  @CTL  functions  supported  by  the  system  device 
drivers.  To  invoke  a  @CTL  function,  point  register  pair  DE  to  the  Device  Control 
Block  (DCB),  load  the  function  code  into  register  C,  and  issue  the  @CTL  super- 
visor call.  You  can  locate  the  DCB  address  by  either  1)  using  the  @GTDCB 
SVC,  or  2)  using  the  @OPEN  SVC  to  open  a  File  Control  Block  containing  the 
device  specification  and  using  the  FCB  address.  See  the  @CTL  supervisor  call 
for  a  list  of  the  function  codes  and  their  meanings. 
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The  @CTL  functions  are  listed  below  for  each  driver. 

Keyboard  Driver  (resident  driver  assigned  to  *KI) 

A  function  value  of  X'03'  clears  the  type-ahead  buffer.  This  serves  the  same 
purpose  as  repeated  calls  to  @KBD  until  no  character  is  available. 

A  function  value  of  X'FF  is  reserved  for  system  use. 

All  other  function  values  are  treated  as  @GET  requests. 

The  module  name  assigned  to  this  driver  is  "$KI'.' 

Video  Driver  (resident  driver  assigned  to  *D0) 

All  @CTL  requests  are  treated  as  if  they  were  @PUT  requests. 

The  module  name  assigned  to  this  driver  is  "$DO'.' 

Printer  Driver  (resident  driver  assigned  to  *PR) 

The  printer  driver  is  transparent  to  all  code  values  when  requested  by  the 
@PUT  SVC.  That  means  that  all  values  from  X'00'  through  X'FF  (0-255)  can 
be  sent  to  the  printer.  If  the  FORMS  filter  is  attached  to  the  *PR  device,  then 
various  codes  are  trapped  and  used  by  the  filter  according  to  parameters  spec- 
ified with  the  FORMS  library  command,  as  follows: 

X'OD'  — Generates  a  carriage  return  and  optionally  a  linefeed  (ADDLF). 

Generates  form  feeds  as  required. 
X'OA'  — Treated  the  same  way  as  X'OD.' 
X'OC'  — Generates  form  feeds  (via  repeated  line  feeds  if  soft  form  feed). 

(FFHARD=OFF) 
XW  — Advances  to  next  tab  column. 
X'06'  —  Sets  top-of-form  by  resetting  the  internal  line  counter  to  zero. 

Other  character  codes  may  be  altered  if  the  user  translation  option  of  the 
FORMS  command  (XLATE)  is  set. 

The  printer  driver  accepts  a  function  value  of  X'00'  via  the  @CTL  request  to 
return  the  printer  status,  if  the  printer  is  available,  the  Z  flag  will  be  set  and  reg- 
ister A  will  contain  X'30.'  If  the  Z  flag  is  reset,  register  A  will  contain  the  four  high- 
order  bits  of  the  parallel  printer  port  (bits  4-7). 

The  module  name  assigned  to  the  printer  driver  is  "$PR'.'  The  module  name  of 
the  FORMS  fitter  is  "$FR 

COM  Driver  (non-resident  driver  for  the  RS-232C) 

This  driver  handles  the  interfacing  between  the  RS-232C  hardware  and  byte 
I/O  (usually  the  *CL  device). 

A  @CTL  function  value  of  X'00'  returns  an  image  of  the  RS-232  status  register 
in  the  accumulator.  The  Z  flag  will  be  set  if  the  RS-232  is  available  for  "sending" 
(that  is,  if  the  transmit  holding  register  is  empty  and  the  flag  conditions  match 
as  specified  by  SETCOM). 

A  function  value  of  X'01'  transmits  a  "modem  break"  until  the  next  character  is 
@PUTto  the  driver. 

A  function  value  of  X'02*  re-initializes  the  UART  to  the  values  last  established 
by  SETCOM. 

A  function  value  of  X'04'  enables  or  disables  the  WAKEUP  feature. 

All  other  function  values  are  ignored  and  the  driver  returns  with  register  A  con- 
taining a  zero  value  and  the  Z  flag  set. 

The  WAKEUP  feature  is  useful  for  application  software  specializing  in  com- 
munications. The  RS-232  hardware  can  generate  a  machine  interrupt  under 
any  of  three  conditions:  when  the  transmit  holding  register  is  empty,  when  a 
received  character  is  available,  or  when  an  error  condition  has  been  detected 
(framing  error,  parity  error,  and  so  on).  The  COM  driver  makes  use  of  the 
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"received  character  available"  interrupt  to  take  control  when  a  fully  formed  char- 
acter is  in  the  holding  register.  The  COM  driver  services  the  interrupt  by  reading 
the  character  and  storing  it  in  a  one-character  buffer.  COM  then  normally 
returns  from  the  interrupt. 

An  application  can  request  that,  instead  of  returning,  control  be  passed  to  the 
application  for  immediate  attention.  Note  that  this  action  would  occur  during 
interrupt  handling,  and  any  processing  by  the  application  must  be  kept  to  a  min- 
imum before  control  is  returned  to  COM  via  a  RET  instruction. 

If  you  use  a  @CTL  function  value  of  X'04,'  then  register  IY  must  contain  the 
address  of  the  handling  routine  in  your  application.  Upon  return  from  the  @CTL 
request,  register  IY  contains  the  address  of  the  previous  WAKEUP  vector.  This 
should  be  restored  when  your  application  is  finished  with  the  WAKEUP  feature. 

When  control  is  passed  to  your  WAKEUP  vector  upon  detection  of  a  "receive 
character  available"  interrupt,  certain  information  is  immediately  available.  Reg- 
ister A  contains  an  image  of  the  UART  status  register.  The  Z  flag  is  set  if  a  valid 
character  is  actually  available.  The  character,  if  any,  is  in  the  C  register. 

Since  system  overhead  takes  a  small  amount  of  time  in  the  @GET  supervisor 
call,  you  may  need  to  @GET  the  character  via  standard  device  interfacing.  This 
ensures  that  any  filtering  or  linking  in  the  *CL  device  chain  will  be  honored,  if, 
on  the  other  hand,  your  application  is  attempting  to  transfer  data  at  a  very  high 
rate  (9600  baud  or  higher),  you  may  need  to  bypass  the  @GET  SVC  and  use 
the  character  immediately  available  in  the  C  register.  Note  that  this  procedure 
bypasses  the  normal  device  chain  (device  routing  and  linking). 

The  module  name  of  the  COM  driver  is  "$CL" 


o 
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8/Using  the  Supervisor  Calls 


» 


Supervisor  Calls  (SVCs)  are  operating  system  routines  that  are  available  to 
assembly  language  programs.  These  routines  alter  certain  system  functions 
and  conditions,  provide  file  access,  and  perform  various  computations.  They 
also  perform  I/O  to  the  keyboard,  video  display,  and  printer. 

Each  SVC  has  a  number  which  you  specify  to  invoke  it.  These  numbers  range 
from  0  to  104. 

In  addition,  under  Version  6.2,  you  can  write  your  own  operating  system  rou- 
tines using  the  numbers  124  through  127  to  install  your  own  SVCs.  See  Ap- 
pendix E,  "Programmable  SVCs"  for  more  information. 


Calling  Procedure 


TocallaTRSDOSSVC: 

1 .  Load  the  SVC  number  for  the  desired  SVC  into  register  A.  Also  load  any 
other  registers  which  are  needed  by  the  SVC,  as  detailed  under  Supervisor 
Calls. 

2.  Execute  a  RST  28H  instruction. 

Note:  If  the  SVC  number  supplied  in  register  A  is  invalid,  the  system  prints  the 
message  "System  Error  xx"  where  xx  is  usually  2B.  It  then  returns  you  to 
TRSDOS  Ready  (not  to  the  program  that  made  the  invalid  SVC  call). 

The  alternate  register  set  (AR  BQ  DE,'  HL')  is  not  used  by  the  operating  system. 


Program  Entry  and  Return  Conditions 


When  a  program  executed  from  the  @CMNDl  SVC  is  entered,  the  system 
return  address  is  placed  on  the  top  of  the  stack.  Register  HL  will  point  to  the  first 
non-blank  character  following  the  command  name.  Register  BC  will  point  to  the 
first  byte  of  the  command  line  buffer. 

Three  methods  of  return  from  a  program  back  to  the  system  are  available:  the 
©ABORT  SVC,  the  ©EXIT  SVC,  and  the  RET  instruction.  For  application  pro- 
grams and  utilities,  the  normal  return  method  is  the  @EXIT  SVC.  if  no  error  con- 
dition is  to  be  passed  back,  the  HL  register  pair  must  contain  a  zero  value.  Any 
non-zero  value  in  HL  causes  an  active  JCL  to  abort. 

The  ©ABORT  SVC  can  be  used  as  an  error  return  back  to  the  system;  it  auto- 
matically aborts  any  active  JCL  processing.  This  is  done  by  loading  the  value 
X'FFFF  into  the  HL  register  pair  and  internally  executing  an  ©EXIT  SVC. 

If  stack  integrity  is  maintained,  a  RET  instruction  can  be  used  since  the  system 
return  address  is  put  on  the  stack  by  ©CMNDi.  This  allows  a  return  if  the  pro- 
gram was  called  with  ©CMNOR. 

Most  of  the  SVCs  in  TRSDOS  Version  6  set  the  Z  flag  when  the  operation  spec- 
ified was  successful.  When  an  operation  fails  or  encounters  an  error,  the  Z  flag 
is  reset  (also  known  as  NZ  flag  set)  and  a  TRSDOS  error  code  is  placed  in  the 
A  register.  The  remaining  SVCs  use  the  Z/NZ  flag  in  differing  ways,  so  you 
should  refer  to  the  description  of  the  SVCs  you  are  using  to  determine  the  exit 
conditions. 
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Supervisor  Calls 


The  TRSDOS  Supervisor  Calls  are: 

Keyboard  SVCs 

Byte  I/O  SVCs 

@CKBRKC 

@CTL 

@KBD 

©GET 

@KEY 

©PUT 

@KEYIN 

File  Control  SVCs 

Printer  and  Video  SVCs 

©CLOSE 

@CLS 

©FEXT 

@DSP 

©FNAME 

@DSPLY 

©FSPEC 

@LOGER 

©INIT 

@LOGOT 

©REMOV 

@MSG 

©OPEN 

@PRT 

©RENAM 

©PRINT 

@VDCTL 

Disk  File  Handler  SVCs 

Disk  SVCs 

©BKSP 

©CKEOF 

©DCINIT 

©LOC 

@DCRES 

©LOF 

@DCSTAT 

©PEOF 

@RDSEC 

©POSN 

@RDSSC 

©READ 

@RSLCT 

©REW 

@RSTOR 

©RREAD 

©SEEK 

©RWRIT 

@SLCT 

©SEEKSC 

@STEPI 

©SKIP 

©VRSEC 

©VER 

@WRSEC 

©WEOF 

@WRSSC 

©WRITE 

@WRTRK 

TRSDOS  Task  Control  SVCs 

System  Control  SVCs 

©ADTSK 

©CKTSK 

©ABORT 

©KLTSK 

©BREAK 

©RMTSK 

©CMNDI 

©RPTSK 

©CMNDR 

©EXIT 

©FLAGS 

@HIGH$ 

©IPL 

©LOAD 

©RUN 

Special  Purpose  Disk  SVCs 

Special  Overlay  SVCs 

©DIRRD 

©CKDRV 

©DIRWR 

©DEBUG 

©GTDCT 

©DODIR 

©HDFMT 

©ERROR 

©RDHDR 

©PARAM 

©RDTRK 

©RAMDIR 

Q 


Software  46 
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Miscellaneous  SVCs 

Special  Purpose  SVCs 

©BANK 

©CHNIO 

©DATE 

©GTDCB 

@DECHEX 

@GTMOD 

@DIV8 

@DIV16 

@HEXDEC 

@HEX8 

@HEX16 

@MUL8 

@MUL16 

©PAUSE 

©SOUND 

©TIME 

©WHERE 

See  the  pages  that  follow  for  a  detailed  description  of  each  supervisor  call. 
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©ABORT 


SVC  Number  21 


Abort  Program 


Loads  HL  with  an  X'FFFF  error  code  and  exits  through  the  @EXIT  supervisor 
call.  Any  active  JCL  processing  is  aborted. 

Entry  Conditions: 

A =21  (X'15') 
General: 

This  SVC  does  not  return. 
Example: 

See  the  example  for  ©EXIT  in  Sample  Program  B,  lines  206-207. 


0 
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@APTSK SVC  Number  29 

Add  an  Interrupt  Level  Task 

Adds  an  interrupt  level  task  to  the  real  time  clock  task  table.  The  task  slot  num- 
ber can  be  0-11;  however,  some  slots  are  already  assigned  to  certain  functions 
in  TRSDOS.  Slot  assignments  0-7  are  low  priority  tasks  executing  every  266.67 
milliseconds.  Slots  8-10  are  medium  priority  tasks  executing  every  33.33  milli- 
seconds. Slot  11  is  a  high  priority  task,  executing  every  16.66  milliseconds  High 
Speed  or  33.33  milliseconds  Low  Speed.  The  system  uses  task  slots  3,  7,  9, 
and  10  for  the  ALIVE,  TRACE,  SPOOL,  and  TYPE- AHEAD  functions, 
respectively. 

It  is  a  good  practice  to  remove  an  existing  task  (using  the  @RMTSK  or 
@KLTSK  SVC)  before  installing  a  new  task  in  the  same  task  slot. 

Entry  Conditions: 

A    =29(X'1D') 

DE = pointer  to  Task  Control  Block  (TCB) 

C   =  task  slot  assignment  {0-1 1 ) 

Exit  Conditions: 

Success  always. 

HL  and  AF  are  altered  by  this  SVC. 

The  Task  Control  Block,  or  TCB,  is  a  2-byte  block  of  RAM  which  contains  the 
address  of  the  task  driver  entry  point.  If  your  task  is  prefixed  with  the  memory 
header  described  earlier  under  "Device  Access,"  then  the  TCB  can  be  stored  in 
the  memory  header  data  storage  area.  If  the  task  is  not  a  driver  or  filter,  the  TCB 
can  be  stored  in  the  memory  header  location  MODDCB.  Upon  entry  to  your 
task  routine,  the  IX  register  contains  the  TCB  address. 

Example: 

See  Sample  Program  F  lines  109-120. 
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@BANK SVC  Number  102 

Memory  Bank  Use 

Controls  32K  memory  bank  operation.  The  top  half  of  the  main  64K  block  is 
bank  0,  and  the  alternate  64K  block  is  divided  into  banks  1  and  2.  The  system 
maintains  two  locations  to  perform  bank  management.  These  areas  are  known 
as  "bank  available  RAM"  (BAR)  and  "bank  in  use  RAM"  (BUR). 

If  the  Stack  Pointer  is  not  X7FFE"  or  lower,  the  SVC  aborts  with  an  Error  43  only 
if  B=0. 

Entry  Conditions: 

A-    102(X'66') 

B      selects  one  of  the  following  functions: 

If  B  =  0,  the  specified  bank  is  selected  and  is  made  addressable. 
The  32K  bank  starts  at  X'8000'  and  ends  at  X'FFFR 
C  =  bank  number  to  be  selected  (0-2) 

If  bit  7  is  set,  then  execution  will  resume  in  the  newty  loaded 
bank  at  the  address  specified. 
HL = address  to  start  execution  in  the  new  bank 
If  B  =  1,  reset  BUR  and  show  the  bank  not  in  use. 

C=bank  number  to  be  selected  (0-2) 
If  B  =  2,  test  BUR  if  bank  is  in  use. 

C = bank  number  to  be  selected  (0-2) 
If  B  =  3,  set  BUR  to  show  bank  in  use. 

C = bank  number  to  be  selected  (0-2) 
If  B  =  4,  return  number  of  bank  currently  selected. 

Exit  Conditions: 

lfB=0: 

Success,  Z  flag  set. 
C  =  the  bank  number  that  was  replaced.  If  bit  7  was  set  in  register 

C  on  entry,  it  is  also  set  on  exit. 
HL= SVC  return  address.  By  keeping  the  contents  of  C  and  HL, 
you  can  later  return  to  the  instruction  following  the  first 
©BANK  SVC.  See  "Interfacing  RAM  Banks  1  and  2"  for  more 
information. 
Failure,  NZ  flag  set.  Bank  not  present  or  parameter  error. 
A  =  error  number 

If  B=1: 

Success,  Z  flag  set.  Bank  available  for  use. 
Failure,  NZ  flag  set.  Bank  not  present. 

lfB=2: 

Success  always. 
If  Z  flag  is  set,  then  the  bank  is  available  for  use. 
If  NZ  flag  is  set,  then  test  register  A: 

If  A  4  X'2B,'  then  the  bank  is  either  in  use  or  it  does  not  exist  on 
your  machine.  Banks  1  and  2  produce  this  error  on  a  64K 
machine. 
If  A = X'2B,'  then  an  entry  parameter  is  out  of  range. 

lfB=3: 

Success,  Z  flag  set.  Bank  is  now  reserved  for  your  use. 
Failure,  NZ  flag  set.  Test  register  A: 
If  A  i=  X'2B,'  then  the  bank  is  already  in  use  or  does  not  exist.  Banks 

1  and  2  produce  this  error  on  a  64K  machine. 
If  A = X'2B,'  then  an  entry  parameter  is  out  of  range. 
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lfB=4: 

Success  always. 
A = number  of  the  bank  which  is  currently  resident 

General: 

AF  is  altered  for  all  functions. 

BC  is  altered  if  the  SVC  is  successful. 

Example: 

See  the  section  "Interfacing  RAM  Banks  1  and  2." 
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@BKSP SVC  Number  61 

Backspace  One  Logical  Record 

Performs  a  backspace  of  one  logical  record. 

Entry  Conditions: 

A    =61  (X'3Dr) 

DE = pointer  to  FCB  of  the  file  to  backspace 

Exit  Conditions: 

If  the  Z  flag  is  set  or  if  A = X'1  C  or  X'  1 D,*  then  the  operation  was  successful. 
The  LOC  pointer  to  the  file  was  backspaced  one  record.  Otherwise, 
A = error  number. 

If  A= X'1  C  is  returned,  the  file  pointer  is  positioned  at  the  end  of  the  file. 
Any  Appending  operations  would  be  performed  here. 
If  A = X'1  D'  is  returned,  the  file  pointer  is  positioned  beyond  the  end  of 
the  file. 

General: 

Only  AF  is  altered  by  this  SVC. 

If  the  LOC  pointer  was  at  record  0  when  the  call  was  executed,  the  results 
are  indeterminate. 

Example: 

See  the  example  for  @LOC  in  Sample  Program  C,  lines  305-311. 
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@BREAK  SVC  Number  103 


Set  Break  Vector 


» 


Sets  a  user  or  system  break  vector.  The  BREAK  vector  is  an  abort  mechanism; 
there  is  no  return. 

The  BREAK  vector  executes  whenever  the  following  conditions  occur  at  the 
same  time:  1)  the  Program  Counter  is  greater  than  X'2400,'  2)  the  BREAK  key 
is  pressed,  and  3)  a  real  time  clock  interrupt  which  executes  30  times  per  sec- 
ond occurs. 

After  executing  this  SVC,  you  must  reset  bit  4  of  SFLAG$.  The  BREAK  flag  in 
KFLAG$  (bit  0)  requires  the  setting  of  SFLAG$  bit  4  and  a  delay  of  0.1  to  0.5 
second  to  clear  any  other  interrupts  that  may  be  pending.  Then  you  can  enter 
your  BREAK  key  handler  (in  which  the  BREAK  key  bit  in  SFLAG$  is  reset).  See 
KFLAG$  and  SFLAG$  in  the  section  about  the  ©FLAGS  SVC  for  more 
information. 

Entry  Conditions: 

A   =103{X'67') 

HL = user  break  vector 

HL = 0  (sets  system  break  vector) 

Exit  Conditions: 

Success  always. 

HL = existing  break  vector  (if  user  break  vector  was  set) 

Note:  ©EXIT  and  ©CMNDI  automatically  restore  BREAK  to  the  system  han- 
dler. ©CMNDR  does  not  do  this. 
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(gCHNIO SVC  Number  20 

Pass  Control  to  Next  Module  in  Device  Chain 


Passes  control  to  the  next  module  in  the  device  chain. 

Entry  Conditions: 

A=20(X'14') 

IX = contents  of  DCB  in  the  header  block 
B  =  GET/PUT/CTL  direction  code  (1/2/4) 
C  =  character  (if  output  request) 

General: 

IX  is  not  checked  for  validity. 

Example: 

See  the  section  "Device  Driver  and  Filter  Templates." 
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(gCKBRKC SVC  Number  106 

Check  BREAK  bit  and  clear  it  Version  6.2  only 

Checks  to  see  if  the  BREAK  key  has  been  pressed.  If  a  BREAK  condition  exists, 
@CKBRKC  resets  the  break  bit,  Bit  0  of  KFLAG$. 

Entry  Conditions: 

A=106(X'6A') 

Exit  Conditions: 

Success  always. 

If  Z  flag  is  set,  the  break  bit  was  not  detected.  If  NZ  flag  is  set,  the 
break  bit  was  detected  and  is  cleared.  If  the  BREAK  key  is  being  de- 
pressed, the  SVC  will  not  return  until  the  key  is  released. 

General: 

Only  AF  is  altered  by  this  SVC. 
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@CKDRV  SVC  Number  33 


Check  Drive 


i 


Checks  a  drive  reference  to  ensure  that  the  drive  is  in  the  system  and  a 
TRSDOS  Version  6  or  LDOS  5.1.3  (Model  111  Hard  Disk  Operating  System)  for- 
matted disk  is  in  place. 

Entry  Conditions: 

A=33(X'21') 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success  always. 

If  Z  flag  is  set,  the  drive  is  ready. 

If  CF  is  set,  the  disk  is  write  protected. 
If  NZ  flag  is  set,  the  drive  is  not  ready.  The  user  may  examine  DCT  +  0 
to  see  if  the  drive  is  disabled. 

Example: 

See  Sample  Program  0,  lines  35-55. 
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@CKEOF  SVC  Number  62 


Check  for  End-Of-File 


Checks  for  the  end  of  file  at  the  current  logical  record  number. 

Entry  Conditions: 

A    =62(X'3E) 

DE  =  pointer  to  the  FCB  of  the  file  to  check 

Exit  Conditions: 

Success  always. 

If  Z  flag  is  set,  LOC  does  not  point  at  the  end  of  file  (LOC  <  LOF). 
If  NZ  flag  is  set,  test  A  for  error  number: 

If  A = X*1  C  LOC  points  at  the  end  of  the  file  (LOC  =  LOF) . 

If  A = X'1  D;  LOC  points  beyond  the  end  of  the  file  (LOC  >  LOF). 

If  A  *  X'1  C*  or  X'1  D,"  then  A = error  number. 

General: 

Only  AF  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  C,  lines  352-353. 
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@CKTSK  SVC  Number  28 


Check  if  Task  Slot  in  Use 


Checks  to  see  if  the  specified  task  slot  is  in  use. 

Entry  Conditions: 

A=28(X'1C) 

C = task  slot  to  check  (0-1 1 ) 

Exit  Conditions: 

Success  always. 

If  Z  flag  is  set,  the  task  slot  is  available  for  use. 
If  NZ  flag  is  set,  the  task  slot  is  already  in  use. 

General: 

AF  and  HL  are  altered  by  this  SVC. 

Example: 

See  Sample  Program  F,  lines  70-73. 
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@CLOSE  SVC  Number  60 


Close  a  File  or  Device 


Terminates  output  to  a  file  or  device.  Any  unsaved  data  in  the  buffer  area  is 
saved  to  disk  and  the  directory  is  updated.  All  files  that  have  been  written  to 
must  be  closed,  as  well  as  all  files  opened  with  UPDATE  or  higher  access. 

If  you  remove  a  diskette  containing  an  open  file,  any  attempt  to  close  the  file 
results  in  the  message: 

**  CLOSE  FAULT  **  error  message,  <ENTER>  to  retry,  <BREAK>  to 
abort 

where  error  message  is  usually  "Drive  not  ready"  You  may  put  the  diskette 
back  in  the  drive  and: 

1 .  Press  CENTER)  to  close  the  file. 

2.  Press  (BREAK)  to  abort  the  close. 

If  you  press  (BREAK),  the  NZ  flag  is  set  and  Register  A  contains  X'20',  the  error 
code  for  an  Illegal  drive  number  error. 

Entry  Conditions: 

A    =60(X'3C*) 

DE  =  pointer  to  FCB  or  DCB  to  close 

Exit  Conditions: 

Success,  Z  flag  set.  The  file  or  device  was  closed.  The  filespec  (excluding 

the  password)  or  the  devspec  is  returned  to  the  FCB  or  DCB. 
Failure,  NZ  flag  set. 
A = error  number 

General: 

Only  AF  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  C,  lines  360-368. 
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@CLS SVC  Number  105 

Clear  Video  Screen  Version  6.2  only 

Clears  the  video  screen  by  sending  a  Home  Cursor  (X'1C)  and  Clear  to  End  of 
Frame  (X'1  F')  sequence  to  the  video  driver. 

Entry  Conditions: 

A  =  105(X'69') 

Exit  Conditions: 

Success,  Z  flag  is  set. 
Failure,  NZ  is  set. 

A  =  error  number 

General: 

Only  AF  is  altered  by  this  SVC. 
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@CMNDI SVC  Number  24 

Execute  Command  with  Return  to  System 

Passes  a  command  string  to  TRSOOS  for  execution.  After  execution  is  com- 
plete, control  returns  to  TRSDOS  Ready.  If  the  command  gets  an  error,  it  still 
returns  to  TRSDOS  Ready. 

Entry  Conditions: 

A   =24(X'18') 

HL = pointer  to  buffer  containing  command  string  terminated  with  X'QD' 
(up  to  80  bytes,  including  the  X'OD') 

General: 

This  SVC  does  not  return. 

Example: 

See  Sample  Program  E,  lines  43-58. 
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@CMNDR  SVC  Number  25 


Execute  Command 


Executes  a  command  or  program  and  returns  to  the  calling  program.  The  exe- 
cuted program  should  maintain  the  Stack  Pointer  and  exit  via  a  RET  instruction. 
All  TRSDOS  library  commands  comply  with  this  requirement. 

If  bit  4  of  CFLAG$  is  set  (see  the  ©FLAGS  SVC),  then  @CMNDR  executes 
only  system  library  commands. 

Entry  Conditions: 

A   =25(X'19') 

HL = pointer  to  buffer  containing  command  string  terminated  with  X'QD' 
(up  to  80  bytes,  including  the  X'QD') 

Exit  Conditions: 

Success  always. 

HL = return  code  (See  the  section  "Converting  to  TRSDOS  Version  6" 

for  information  on  return  codes.) 
Registers  AF,  BC,  DE,  IX,  and  IY  are  altered  by  the  command  or  pro- 
gram executed  by  this  SVC. 
If  the  command  invokes  a  user  program  which  uses  the  alternate  reg- 
isters, they  are  modified  also. 

Example: 

See  Sample  Program  E,  lines  18-29. 
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@CTL SVC  Number  5 

Output  a  Control  Byte 

Outputs  a  control  byte  to  a  logical  device.  The  DCB  TYPE  byte  (DCB +0,  Bit  2) 
must  permit  CTL  operation.  See  the  section  "@CTL  Interfacing  to  Device  Driv- 
ers" for  information  on  which  of  the  functions  listed  below  are  supported  by  the 
system  device  drivers. 

Entry  Conditions: 

A    =5(X'051) 

DE = pointer  to  DCB  to  control  output 

C  selects  one  of  the  following  functions: 

If  C  =  0,  the  status  of  the  specified  device  will  be  returned. 

If  C=  1,  the  driver  is  requested  to  send  a  BREAK  or  force  an  interrupt. 

If  C= 2,  the  initialization  code  of  the  driver  is  to  be  executed. 

If  C= 3,  all  buffers  in  the  driver  are  to  be  reset.  This  causes  all  pending 

I/O  to  be  cleared. 
If  C = 4,  the  wakeup  vector  for  an  interrupt-driven  driver  is  specified  by 
the  caller. 

IY  =  address  to  vector  when  leaving  driver.  If  IY  =  0,  then 

the  wakeup  vector  function  is  disabled.  The  RS-232C 

driver  COM/DVR  ($CL),  is  the  only  system  driver  that 

provides  wakeup  vectoring. 

If  C  =  8,  the  next  character  to  be  read  will  be  returned.  This  allows  data 

to  be  "previewed"  before  the  actual  @GET  returns  the  character. 

Exit  Conditions: 

lfC  =  0, 

Z  flag  set,  device  is  ready 
NZ  flag  set,  device  is  busy 

A = status  image,  if  applicable 
Note:  This  is  a  hardware  dependent  image. 
lfC=1, 

Success,  Z  flag  set.  BREAK  or  interrupt  generated. 
Failure,  NZ  flag  set 
A = error  number 
HC=2, 

Success,  Z  flag  set.  Driver  initialized. 
Failure,  NZ  flag  set 
A= error  number 
lfC=3, 

Success,  Z  flag  set.  Buffers  cleared. 
Failure,  NZ  flag  set. 
A = error  number 
lfC=4, 

Success  always. 

IY  =  previous  vector  address 
This  function  is  ignored  if  the  driver  does  not  support  wakeup 
vectoring. 
lfC=8, 

Success,  Z  flag  set.  Next  character  returned. 

A = next  character  in  buffer 
Failure,  NZ  flag  set.  Test  register  A: 
If  A = 0,  no  pending  character  is  in  buffer 
If  A  =£  0,  A  contains  error  number.  (TRSDOS  driver  returns  Error  43.) 
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General: 

BC,  OE,  HL,  and  IX  are  saved. 

Function  codes  5  to  7,  9  to  31,  and  255  are  reserved  for  the  system.  Function  codes 
32  to  254  are  available  for  user  definition. 

Entry  and  exit  conditions  for  user-defined  functions  are  up  to  the  design  of  the  user- 
supplied  driver. 

Example: 

See  the  section  "Device  Driver  and  Filter  Templates." 
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©DATE  SVC  Number  18 


Get  Date 


» 


Returns  today's  date  in  display  format  (MM/DD/YY). 

Entry  Conditions: 

A   =18(X*12') 

HL = pointer  to  8-byte  buffer  to  receive  date  string 

Exit  Conditions: 

Success  always. 

HL = pointer  to  the  end  of  the  buffer  supplied  + 1 
DE= pointer  to  start  of  DATE$  storage  area  in  TRSDOS 
BC  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  F,  lines  252-253. 


g&m 


Software  67 


@DCINIT  SVC  Number  42 


Initialize  the  FDC 


Issues  a  disk  controller  initialization  command.  The  floppy  disk  driver  treats  this 
the  same  as  @RSTOR  (SVC  44). 

Entry  Conditions: 

A  =  42(X'2A') 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A = error  number 

Example: 

See  the  example  for  @CKDRV  in  Sample  Program  D,  lines  38-39. 
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@DCRES  SVC  Number  43 


Reset  the  FDC 


» 


Issues  a  disk  controller  reset  command.  The  floppy  disk  driver  treats  this  the 
same  as  @RSTOR  (SVC  44). 

Entry  Conditions: 

A  =  43(X'2B') 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A = error  number 

Example: 

See  the  example  for  @CKDRV  in  Sample  Program  D,  lines  38-39. 
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@DCSTAT SVC  Number  40 

Test  if  Drive  Assigned  in  DCT 

Tests  to  determine  whether  a  drive  is  defined  in  the  Drive  Code  Table  (DCT). 

Entry  Conditions: 

A=  40(X'28') 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success  always. 

If  Z  is  set,  the  specified  drive  is  already  defined  in  the  DCT. 
If  NZ  is  set,  the  specified  drive  is  not  defined  in  the  DCT. 

General: 

Only  AF  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  D,  lines  27-33. 
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@DEBUG  SVC  Number  27 


Enter  DEBUG 


» 


Forces  the  system  to  enter  the  DEBUG  utility.  Pressing  ®  (EhtEh)  from  the 
DEBUG  monitor  causes  program  execution  to  continue  with  the  next  instruc- 
tion. If  you  want  to  use  the  functions  in  the  extended  debugger  when  DEBUG 
is  entered  in  this  fashion,  you  must  issue  the  DEBUG  (E)  command  (optionally 
with  the  @CMNDR  SVC)  before  this  SVC  is  executed. 

Entry  Conditions: 

A=27(X'1B') 

General: 

This  SVC  does  not  return  unless  ©  is  entered  in  DEBUG. 

Example: 

See  Sample  Program  A,  lines  54-60. 
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@DECHEX SVC  Number  96 

Convert  Decimal  ASCII  to  Binary 

Converts  a  decimal  ASCII  string  to  a  16-bit  binary  number.  Overflow  is  not 
trapped.  Conversion  stops  on  the  first  out-of-range  character. 

Entry  Conditions: 

A   =96(X'60') 

HL = pointer  to  decimal  string 

Exit  Conditions: 

Success  always. 

BC = binary  conversion  of  ASCII  string 
HL  =pointer  to  the  terminating  byte 
AF  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  B,  lines  88-95. 
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@DIRRD SVC  Number  87 

Directory  Record  Read 

Reads  a  directory  sector  that  contains  the  directory  entry  for  a  specified  Direc- 
tory Entry  Code  (DEC).  The  sector  is  placed  in  the  system  buffer  and  the  reg- 
ister pair  HL  points  to  the  first  byte  of  the  directory  entry  specified  by  the  DEC. 

Entry  Conditions: 

A=87(X'57) 

B  =  Directory  Entry  Code  of  the  file 

C = logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 

HL = pointer  to  directory  entry  specified  by  register  B 
Failure,  NZ  flag  set. 

A   =  error  number 

HL  is  altered. 

General: 

AF  is  always  altered. 

If  the  drive  does  not  contain  a  disk,  this  SVC  may  hang  indefinitely  waiting 
for  formatted  media  to  be  placed  in  the  drive.  The  programmer  should 
perform  a  @CKDRV  SVC  before  executing  this  call. 

If  the  Directory  Entry  Code  is  invalid,  the  SVC  may  not  return  or  it  may 
return  with  the  Z  flag  set  and  HL  pointing  to  a  random  address.  Care 
should  be  taken  to  avoid  using  the  wrong  value  for  the  DEC  in  this  call. 

Example: 

See  Sample  Program  C,  lines  152-174. 
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@DIRWR SVC  Number  88 

Directory  Record  Write 

Writes  the  system  buffer  back  to  the  disk  directory  sector  that  contains  the 
directory  entry  of  the  specified  DEC. 

Entry  Conditions: 

A  =  88(X'58") 

B  =  Directory  Entry  Code  of  the  file 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 

HL = pointer  to  directory  entry  specified  by  register  B 
Failure,  NZ  flag  set. 

A   =  error  number 

HL  is  altered. 

General: 

AF  is  always  altered. 

If  the  drive  does  not  contain  a  disk,  this  SVC  may  hang  indefinitely  waiting 
for  formatted  media  to  be  placed  in  the  drive.  The  programmer  should 
perform  a  @CKDRV  SVC  before  executing  this  call. 

If  the  Directory  Entry  Code  is  invalid,  the  SVC  may  not  return  or  it  may 
return  with  the  Z  flag  set  and  HL  pointing  to  a  random  address.  Care 
should  be  taken  to  avoid  using  the  wrong  value  for  the  DEC  in  this  call. 

Example: 

See  the  example  for  @DIRRD  in  Sample  Program  C,  lines  152-174. 
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@DIV8  SVC  Number  93 


8-Bit  Divide 


i 


Performs  an  8-bit  unsigned  integer  divide. 

Entry  Conditions: 

A  =  93(X'5D') 
E  =  dividend 
C= divisor 

Exit  Conditions: 

Success  always. 
A  =  quotient 
E  =  remainder 
No  other  registers  are  altered. 

Example: 

See  Sample  Program  B,  lines  61-64. 
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@DIV16 SVC  Number  94 

16-Bit  by  8-Bit  Divide 


Performs  a  division  of  a  16-bit  unsigned  integer  by  an  8-bit  unsigned  integer. 

Entry  Conditions: 

A    =94(X'5E') 
HL  =  dividend 
C   =  divisor 

Exit  Conditions: 

Success  always. 
HL= quotient 
A   =  remainder 
No  other  registers  are  altered. 

Example: 

See  Sample  Program  B,  lines  105-109. 
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@DODIR SVC  Number  34 

Do  Directory  Display  /Buffer 

Reads  files  from  a  disk  directory  or  finds  the  free  space  on  a  disk.  The  directory 
information  is  either  displayed  on  the  screen  (in  five-across  format)  or  sent  to  a 
buffer.  The  directory  information  buffer  consists  of  18  bytes  per  active,  visible 
file:  the  first  16  bytes  of  the  directory  record,  plus  the  ERN  (ending  record  num- 
ber). An  X'FF'  marks  the  buffer  end. 

Entry  Conditions: 

A  =  34(X'22') 

C = logical  drive  number  (0-7) 
B  selects  one  of  the  following  functions: 
If  B  =  0,  the  directory  of  the  visible,  non-system  files  on  the  disk  in  the 
specified  drive  is  displayed  on  the  screen.  The  filenames  are  dis- 
played in  columns,  5  filenames  per  line. 
If  B  =  1,  the  directory  is  written  to  memory. 

HL = pointer  to  buffer  to  receive  information 
If  B  =  2,  a  directory  of  the  files  on  the  specified  drive  is  displayed  for  files 
that  are  visible,  non-system,  and  match  the  extension  partspec 
pointed  to  by  HL. 
HL= partspec  for  the  filename's  extension 

This  field  must  contain  a  valid  3-character  extension,  padded 
with  dollar  signs  ($).  For  example,  to  display  all  visible,  non- 
system  files  that  have  the  letter  'C  as  the  first  character  of  the 
extension,  HL  should  point  to  the  string  "C$$'.' 
If  B  =  3,  a  directory  of  the  files  on  the  specified  drive  is  written  to  the  buffer 
that  is  specified  by  HL  for  files  that  match  the  extension  partspec 
pointed  to  by  HL. 
HL = pointer  to  the  3-byte  partspec  and  to  the  buffer  to  receive  the 

directory  records  (see  general  notes) 
Keep  in  mind  that  the  area  pointed  to  by  HL  is  shared.  If  you  are 
using  this  buffer  more  than  once,  you  have  to  re-create  the 
partspec  in  the  buffer  before  each  call  because  the  previous 
call  will  have  erased  the  partspec  by  writing  the  directory 
records. 
If  B  =  4,  the  disk  name,  original  free  space,  and  current  free  space  on  the 
disk  is  read. 
HL = pointer  to  a  20-byte  buffer  to  receive  information 

Exit  Conditions: 

Success,  Z  flag  set. 

If  B  =  1  or  3,  the  directory  records  have  been  stored. 

HL  =  pointer  to  the  beginning  of  the  buffer 
If  B  =  0  or  2,  the  filenames  or  matching  filenames  are  displayed  with  5 

filenames  per  line. 
If  B  =  4,  the  disk  name  and  free  space  information  are  stored  in  the 
format: 
Bytes   0-7  =  Disk  name.  Disk  name  is  padded  on  the  right 

with  blanks  (X'20'). 
Bytes   8-15  =  Creation  date  (the  date  the  disk  was  formatted 
or  was  the  target  disk  in  a  mirror  image 
backup).  The  date  is  in  the  format  MM/DD/YY. 
Bytes  16-1 7  =  Total  K  originally  available  in  binary  LSB-MSB 

format. 
Bytes  18-19  =  Free  K  available  now  in  binary  LSB-MSB 
format. 
HL = pointer  to  the  beginning  of  the  data  area 
Failure,  NZ  flag  set. 
A = error  number 
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General: 

AF  is  the  only  register  altered  by  this  SVC. 

The  size  of  the  buffer  to  receive  directory  records  must  be  large  enough  to 
hold  directory  entries  for  the  maximum  number  of  files  allowed  on  the 
drive  and  disk  you  specify.  For  example,  if  the  drive  is  a  hard  disk,  you 
must  be  able  to  store  256  directory  entries,  and  each  entry  requires  18 
bytes  of  storage.  For  more  information  on  calculating  the  amount  of 
space  needed  for  this  buffer,  see  the  tables  under  "Directory  Records." 
They  give  the  maximum  number  of  entries  allowed  on  a  given  type  of 
disk.  You  must  add  2  records  to  this  value  when  B  =  1  to  store  the  direc- 
tory entry  for  DIR/SYS  and  BOOT/SYS. 

Example: 

See  Sample  Program  E,  lines  32-40. 
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@DSP SVC  Number  2 

Display  Character 

Outputs  a  byte  to  the  video  display.  The  byte  is  displayed  at  the  current  cursor 
position. 

Entry  Conditions: 

A=2(X'02') 

C= byte  to  display 

Exit  Conditions: 

Success,  Z  flag  set. 

A = byte  displayed 
Failure,  NZ  flag  set. 

A  =  error  number 

General: 

DE  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  C,  lines  219-221. 
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@DSPLY SVC  Number  10 

Display  Message  Line 

Displays  a  message  line,  starting  at  the  current  cursor  position.  The  line  must 
be  terminated  with  either  a  carriage  return  (X'0D)  or  an  ETX  (X'03').  If  an  ETX 
terminates  the  line,  the  cursor  is  positioned  immediately  after  the  last  character 
displayed. 

Entry  Conditions: 

A    =10(X'0A') 

HL = pointer  to  first  byte  of  message 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A = error  number 

General: 

AF  and  DE  are  altered  by  this  SVC. 

Example: 

See  Sample  Program  C,  lines  35-37. 
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©ERROR SVC  Number  26 

Entry  to  Post  an  Error  Message 

Provides  an  entry  to  post  an  error  message.  If  bit  7  of  register  C  is  set,  the  error 
message  is  displayed  and  return  is  made  to  the  calling  program.  If  bit  6  is  not 
set,  the  extended  error  message  is  displayed.  Under  versions  prior  to  6.2  the 
error  display  is  in  the  following  format: 

***   Errcod=xx*    Error    message    sttins    *** 
<filespec    or    devspec) 

Referenced    at    X'dddd' 

Under  Version  6.2  the  error  display  is  in  the  following  format: 

♦  ♦Error  code  =  xxt   Returns  to  X'  dddd' 
**Error  message  strinsr 

<  fi lespec  >  dev  spec >  or  open  FCB/DCB   status) 
Last  SVC  =  rrnn  t   Returned  to  X  '  r r r r  ' 

dddd  is  the  return  address  of  the  ©ERROR  SVC  in  the  application  program. 

nnn  is  the  last  SVC  executed  before  the  (a.  ERROR  SVC  request. 

rrrr  is  the  address  the  previous  SVC  returned  to  in  the  application  program. 

If  bit  6  is  set,  then  only  the  "Error  message  string"  is  displayed.  This  bit  is 
ignored  if  bit  6  of  SFLAG$  (the  extended  error  message  bit)  is  set.  If  bit  6  of 
CFLAG$  is  set,  then  no  error  message  is  displayed.  If  bit  7  of  CFLAG$  is  set, 
then  the  "Error  message  string"  is  placed  in  a  user  buffer  pointed  to  by  register 
pair  DE.  See  ©FLAGS  (SVC  101)  for  more  information  on  SFLAGS  and 
CFLAG$. 

Entry  Conditions: 

A  =  26(X'1A) 

C  =  error  number  with  bits  6  and  7  optionally  set 

Exit  Conditions: 

Success  always. 

General: 

To  avoid  a  looping  condition  that  could  result  from  the  display  device  gen- 
erating an  error,  do  not  check  for  errors  after  returning  from  ©ERROR. 

If  you  do  not  set  bit  6  of  register  C,  then  you  should  execute  this  SVC  only 
after  an  error  has  actually  occurred. 

Example: 

See  Sample  Program  C,  lines  379-389. 
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@EXIT  SVC  Number  22 


Exit  to  TRSDOS 


This  is  the  normal  program  exit  and  return  to  TRSDOS.  An  error  exit  can  be 
done  by  placing  a  non-zero  value  in  HL.  Values  1  to  62  indicate  a  primary  error 
as  described  in  TRSDOS  Error  Codes  (Appendix  A).  {A  non-zero  value  in  HL 
causes  an  active  JCL  to  abort.) 

Entry  Conditions: 

A   =  22(X'16') 
HL= Return  Code 

If  HL  =  0,  then  no  error  on  exit. 

If  HL^O,  then  the  ©ABORT  SVC  returns  X'FFFF  in  HL  automatically. 

General: 

This  SVC  does  not  return. 

Example: 

See  Sample  Program  B,  lines  206-207 
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@FEXT SVC  Number  79 

Set  Up  Default  File  Extension 

Inserts  a  default  file  extension  into  the  File  Control  Block  if  the  file  specification 
entered  contains  no  extension.  @FEXT  must  be  done  before  the  file  is  opened. 

Entry  Conditions: 

A    =79(X'4F) 
DE= pointer  to  FCB 

HL= pointer  to  default  extension  (3  characters;  alphabetic  characters 
must  be  upper  case  and  first  character  must  be  a  letter) 

Exit  Conditions: 

Success  always. 

AF  and  BC  are  altered  by  this  SVC. 

If  the  default  extension  is  used,  HL  is  also  altered. 

Example: 

See  Sample  Program  C,  lines  111-132. 
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@FLAGS SVC  Number  101 

Point  IY  to  System  Flag  Table 

Points  the  I Y  register  to  the  base  of  the  system  flag  table.  The  status  flags  listed 
below  can  be  referenced  off  IY  You  can  alter  those  bits  marked  with  an  asterisk 
(*).  Bits  without  an  asterisk  are  indicators  of  current  conditions,  or  are  unused 
or  reserved. 

Note:  You  may  wish  to  save  KFLAG$  and  SFLAG$  if  you  intend  to  modify  them 
in  your  program,  and  restore  them  on  exit. 

Entry  Conditions: 

A  =101  (X'65) 

Exit  Conditions: 

Success  always. 

IY = pointer  to  the  following  system  information: 

IY- 1       Contains  the  overlay  request  number  of  the  last  system  module 
resident  in  the  system  overlay  region. 

IY  +  0  =  AFLAGS  (allocation  flag  under  Version  6.2  only) 

Contains  the  starting  cylinder  number  to  be  used  when 
searching  for  free  space  on  a  diskette.  It  is  normally  1 . 
If  the  starting  cylinder  number  is  larger  than  the  number 
of  cylinders  for  a  particular  drive,  1  is  used  for  that  drive. 

IY  +  2    =CFLAG$ 

*  bit  7      —  If  set,  then  (aERROR  will  transfer  the  "Error  message 

string"  to  your  buffer  instead  of  displaying  it.  The  mes- 
sage is  terminated  with  X'0D.' 

*  bit  6      —  If  set,  do  not  display  system  error  messages  0-62.  See 

(a  ERROR  (SVC  26)  for  more  information. 

*  bit  5       —  If  set,  sysgen  is  not  allowed. 

*  bit  4      —  If  set,  then  @CMNDR  will  execute  only  system  library 

commands, 
bit  3      —  If  set,  @RUN  is  requested  from  either  the  SET  or 

SYSTEM  (DRIVER  = )  commands, 
bit  2      —  If  set,  @KEYIN  is  executing  due  to  a  request  from 

SYS1. 
bit  1       —  If  set,  @CMNDR  is  executing.  This  bit  is  reset  by 

@EXITand@CMNDI. 

*  bit  0      —  If  set,  HIGHS  cannot  be  changed  using  @HIGH$ 

(SVC  10O).  This  bit  is  reset  by  @EXIT  and  @CMNDI. 
IY  +  3   =DFLAG$    (device  flag) 

*  bit  7      —  "1"  if  GRAPHIC  printer  capability  desired  on  screen 

print  ((CONTROL)  CD  causes  screen  print.  See  the  SYS- 
TEM (GRAPHIC)  command  under  "Technical  Infor- 
mation on  TRSDOS  Commands  and  Utilities.") 

bit  6      —  "1"  if  KSM  module  is  resident 

bit  5      —  Currently  unused 

bit  4      —  "1"  if  MemDisk  active 

bit  3      —  Reserved 

bit  2      —  "1"  if  Disk  Verify  is  enabled 

*  bit  1       —  "1"  if  TYPE-AHEAD  is  active 
bit  0      —  "  1"  if  SPOOL  is  active 

IY  +  4  =  EFLAG$  (ECI  flag  under  Version  6.2  only) 

Indicates  the  presence  of  an  ECI  program.  If  any  of  the 
bits  are  set,  an  ECI  is  used,  rather  than  the  SYS1  inter- 
preter. The  ECI  program  may  use  these  bits  as  necce- 
sary.  However,  at  least  one  bit  must  be  set  or  the  ECI  is 
not  executed. 
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IY  +  5   =FEMSK$   (mask  for  port  0FEH) 
IY  +  8   =IFLAG$     (international  flag) 

*  bit  7      —  If  "1,"  7-bit  printer  filter  is  active 

If  "0,"  normal  8-bit  filters  are  present 

*  bit  6      —  If  "1,"  international  character  translation  will  be  per- 

formed by  printer  driver 

If  "0,"  characters  received  by  printer  driver  will  be  sent 

to  the  printer  unchanged 
bit  5      —  Reserved  for  future  languages 
bit  4      —  Reserved  for  future  languages 
bit  3      —  Reserved  for  future  languages 
bit  2      —  Reserved  for  future  languages 
bit  1       —  If  "1"  German  version  of  TRSDOS  is  present 
bit  0      —  If  "1f  French  version  of  TRSDOS  is  present 
If  bits  5-0  are  all  zero,  then  USA  version  of  TRSDOS  is  present. 
I Y  + 1 0  =  KFLAG$    {keyboard  flag) 

bit  7      —  "1"  if  a  character  is  present  in  the  type-ahead  buffer 
bit  6      —  Currently  unused 

*  bit  5      —  "1"  if  CAPS  lock  is  set 
bit  4      —  Currently  unused 

bit  3      —  Currently  unused 

*  bit  2      —  "1"  if  (IHTEff)  has  been  pressed 

*  bit  1       —  "1"  if  (SHIFT)  ©  has  been  pressed  (PAUSE) 

*  bit  0      —  "1"  if  (BREAK)  has  been  pressed 

Note:  To  use  bits  0-2,  you  must  first  reset  them  and  then  test  to 

see  if  they  become  set. 
IY  + 1 2  =  MODOUT  (image  of  port  0ECH) 
IY+ 13=  NFLAG$  (network  flag  under  Version  6.2) 

bit  7      —  Reserved  for  system  use. 

bit  6  —  If  set,  the  application  program  is  in  the  task  processor. 
Programmers  must  not  modify  this  bit. 

bit  5      —  Reserved  for  system  use. 

bit  4       —  Reserved  for  system  use. 

bit  3      —  Reserved  for  system  use. 

bit  2      —  Reserved  for  system  use. 

bit  1       —  Reserved  for  system  use. 

*  bit  0      —  If  set,  the  "file  open  bit"  is  written  to  the  directory. 
IY+  14=OPREG$  (memory  management  &  video  control  image) 

I Y  + 1 7=  RFLAG$  (retry  flag  under  Version  6.2  only) 

Indicates  the  number  of  retrys  for  the  floppy  disk  driver. 

This  should  be  an  even  number  larger  than  two. 
I Y  + 1 8  =  SFLAG$    (system  flag) 

bit  7      —  "1"  if  DEBUG  is  to  be  turned  on 

*  bit  6      — "1"  if  extended  error  messages  desired  (see 

©ERROR  for  message  format);  overrides  the  setting 
of  bit  6  of  register  C  on  ©ERROR  (SVC  26)  and 
should  be  used  only  when  testing 
bit  5      —  "1"  if  DO  commands  are  being  executed 

*  bit  4      —  "1"  if  BREAK  disabled 

bit  3  —  "1"  if  the  hardware  is  running  at  4  mhz  (SYSTEM 
(FAST)).  If  "0,"  the  hardware  is  running  at  2  mhz  (SYS- 
TEM (SLOW)). 

*  bit  2      —  "1"  if  LOAD  called  from  RUN 

*  bit  1       —  "1"  if  running  an  EXECute  only  file 

*  bit  0      —  "1"  specifies  no  check  for  matching  LRL  on  file  open 

and  do  not  set  file  open  bit  in  directory.  This  bit  should 
be  set  just  before  executing  an  ©OPEN  (SVC  59)  if 
you  want  to  force  the  opened  file  to  be  READ  only  dur- 
ing current  I/O  operations.  As  soon  as  either  call  is 
executed,  SFLAG$  bit  0  is  reset.  If  you  want  to  disable 
LRL  checking  on  another  file,  you  must  set  SFLAG$ 
bit  0  again. 
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IY  +  1 9  =  TFLAG$  (type  flag  under  Version  6.2  oniy) 

Identifies  the  Radio  Shack  hardware  model.  TFLAG$ 
allows  programs  to  be  aware  of  the  hardware  environ- 
ment and  the  character  sets  available  for  the  display. 
Current  assignments  are: 

2  indicates  Model  II 

4  indicates  Model  4 

5  indicates  Model  4P 
12  indicates  ModeM  2 

IY  +  20=  UFLAG$  (user  flag  under  Version  6.2  only) 

May  be  set  by  application  programs  and  is  sysgened 

properly. 
IY  +  21  =VFLAG$ 

bit  7      —  Reserved  for  system  use 

*  bit  6      —  "1"  selects  solid  cursor,  "0"  selects  blinking  cursor 
bit  5      —  Reserved  for  system  use 

*  bit  4      —  "1"  if  real  time  clock  is  displayed  on  the  screen 
bits  0-3  —  Reserved  for  system  use 

IY  +  22  =  WRINTMASK$    (mask  for  WRINTMASK  port) 

IY  +  26  =  SVCTABPTR$     (pointer  to  the  high  order  byte  of  the  SVC  table 

address;  low  order  byte  =  00) 
IY  +  27  =  Version  ID  byte    (60H  =  TRSDOS  version  6.0.x.x, 

61H=TRSDOS  version  6.1.x.x,  etc.) 
IY-47  =  Operating  system  release  number.  Provides  a  third  and  fourth 

character  (12H  =  TRSDOS  version  x.x.1.2) 
IY  +  28 
to 

IY  + 30  =  @ICNFG  vector 
IY  +  31 
to 
IY  + 33  =  @KITSK  vector 
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@FNAME  SVC  Number  80 


Get  Filename 


Gets  the  filename  and  extension  from  the  directory  using  the  specified  Direc- 
tory Entry  Code  (DEC)  for  the  file. 

Entry  Conditions: 

A    =80(X'50') 

DE=po/nfer  to  16-byte  buffer  to  receive  filename/extension.drive,  fol- 
lowed by  a  X'QD'  as  a  terminator 
B    =  DEC  of  desired  file 
C   =  logical  drive  number  of  drive  containing  file  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 

HL = pointer  to  directory  entry  specified  by  register  B 
Failure,  NZ  flag  set. 

A   =  error  number 

HL  is  altered. 

General: 

AF  and  BC  are  always  altered. 

If  the  drive  does  not  contain  a  disk,  this  SVC  may  hang  indefinitely  waiting 

for  formatted  media  to  be  placed  in  the  drive.  The  programmer  should 

perform  a  @CKDRV  SVC  before  executing  this  call. 
If  the  Directory  Entry  Code  is  invalid,  the  SVC  may  not  return  or  it  may 

return  with  the  Z  flag  set  and  HL  pointing  to  a  random  address.  Care 

should  be  taken  to  avoid  using  the  wrong  value  for  the  DEC  in  this  call. 

Example: 

See  Sample  Program  C,  lines  274-286. 
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@FSPEC SVC  Number  78 

Assign  File  or  Device  Specification 

Moves  a  file  or  device  specification  from  an  input  buffer  into  a  File  Control  Block 
(FCB).  Conversion  of  lower  case  to  upper  case  is  made  automatically. 

Entry  Conditions: 

A   =78(X'4E') 

HL = pointer  to  buffer  containing  filespec  or  devspec 

DE= pointer  to  32-byte  FCB  or  DCB 

Exit  Conditions: 

Success  always. 

If  the  Z  flag  is  set,  the  file  specification  is  valid. 

HL = pointer  to  terminating  character 

DE= pointer  to  start  of  FCB 
If  the  NZ  flag  is  set,  a  syntax  error  was  found  in  the  filespec. 

HL = pointer  to  invalid  character 

DE= pointer  to  start  of  FCB 

A    =  invalid  character 

General: 

AF  and  BC  are  altered. 

Example: 

See  Sample  Program  C,  lines  53-65. 
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@GET SVC  Number  3 

Get  One  Byte  From  Device  or  File 

Gets  a  byte  from  a  logical  device  or  a  file.  The  DCB  TYPE  byte  (DCB  +  0,  Bit  0) 
must  permit  a  GET  operation  for  this  call  to  be  successful. 

Entry  Conditions: 

A    =3(X'03') 

DE  = pointer  to  DCB  or  FCB 

Exit  Conditions: 

Success,  Z  flag  set. 

A  =  character  read  from  the  device  or  file 
Failure,  NZ  flag  set.  Test  register  A: 

If  A  =  0,  no  character  was  available. 

If  A  *  0,  A  contains  error  number. 

Example: 

See  the  section  "Device  Driver  and  Filter  Templates." 
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@GTDCB SVC  Number  82 

Get  Device  Control  Block  Address 

Finds  the  location  of  a  Device  Control  Block  (DCB).  If  DE  =  0  (no  device  name 
specified),  HL  returns  the  address  of  the  first  unused  DCB  found. 

Entry  Conditions: 

A    =  82(X'52') 

DE = 2-character  device  name  (E = first  character,  D  =  second  character) 

Exit  Conditions: 

Success,  Z  flag  set.  DCB  was  found. 

HL = pointer  to  start  of  DCB 
Failure,  NZ  flag  set.  No  DCB  was  available. 

A  =  Error  8  (Device  not  available) 

HL  is  altered. 

General: 

AF  is  always  altered  by  this  SVC. 

Example: 

See  the  section  "Device  Driver  and  Filter  Templates." 
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@GTDCT  SVC  Number  81 


Get  Drive  Code  Table  Address 


Gets  the  address  of  the  Drive  Code  Table  for  the  requested  drive. 

Entry  Conditions: 

A =81  (X'51') 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success  always. 

IY = pointer  to  the  DCT  entry  for  the  specified  drive 
AF  is  always  altered  by  this  SVC. 

General: 

If  the  drive  number  is  out  of  range,  the  IY  pointer  will  be  invalid.  This  call 
does  not  return  Z/NZ  to  indicate  if  the  drive  number  specified  is  valid 
(0-7)  or  enabled. 

Example : 

See  the  example  for  @DCSTAT  in  Sample  Program  D,  lines  27-33. 
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@GTMOD SVC  Number  83 

Get  Memory  Module  Address 

Locates  a  memory  module,  if  the  standard  memory  header  is  at  the  start  of  the 
module.  The  scanning  starts  with  the  system  drivers  in  low  memory,  then 
moves  to  any  high  memory  modules.  If  any  routine  is  encountered  that  does  not 
start  with  a  proper  header,  scanning  stops. 

Entry  Conditions: 

A    =83(X'53') 

DE = pointer  to  memory  module  name  in  upper  case,  terminated  with  any 
character  in  the  range  00-31 

Exit  Conditions: 

Success  always. 

If  the  Z  flag  is  set,  the  module  was  found. 

HL = pointer  to  first  byte  of  memory  header 
DE= pointer  to  first  byte  after  module  name 

If  the  NZ  flag  is  set,  the  module  was  not  found. 
HL  is  altered. 

General: 

AF  is  always  altered  by  this  SVC. 

Example: 

See  Sample  Program  F,  lines  144-154. 
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@HDFMT  SVC  Number  52 


Hard  Disk  Format 


Passes  a  format  drive  command  to  a  hard  disk  driver.  If  the  hard  disk  controller 
accepts  it  as  a  valid  command,  then  it  formats  the  entire  disk  drive.  If  the  hard 
disk  controller  does  not  accept  it,  then  an  error  is  returned.  Radio  Shack  hard- 
ware does  not  currently  support  @HDFMT. 

Entry  Conditions: 

A  =  52(X'34') 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 
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@HEXDEC SVC  Number  97 

Convert  Binary  to  Decimal  ASCII 

Converts  a  binary  number  in  HL  to  decimal  ASCII. 

Entry  Conditions: 

A   =97(X'6T) 

HL = number  to  convert 

DE= pointer  to  5-character  buffer  to  hold  converted  number 

Exit  Conditions: 

Success  always. 

DE  =  pointer  to  end  of  buffer  + 1 

AF,  BC,  and  HL  are  altered  by  this  SVC. 

Example: 

See  Sample  Program  B,  lines  73-76. 
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@HEX8 SVC  Number  98 

Convert  1  Byte  to  Hex  ASCII 

Converts  a  1-byte  number  to  hexadecimal  ASCII. 

Entry  Conditions: 

A    =  98(X'62') 

C  =  number  to  convert 

HL= pointer  to  a  2-character  buffer  to  hold  the  converted  number 

Exit  Conditions: 

Success  always. 

HL = pointer  to  the  end  of  buffer  + 1 
Only  AF  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  B,  lines  236-246. 
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@HEX16 SVC  Number  99 

Convert  2  Bytes  to  Hex  ASCII 

Converts  a  2-byte  number  to  hexadecimal  ASCII. 

Entry  Conditions: 

A    =99(X'63') 

DE=  number  to  convert 

HL= pointer  to  4-character  buffer  to  hold  converted  number 

Exit  Conditions: 

Success  always. 

HL = pointer  to  end  of  buffer  + 1 
Only  AF  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  B,  lines  248-258. 
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@HIGH$ SVC  Number  100 

Get  or  Alter  HIGH$  or  LOW$ 

Provides  the  means  to  read  or  alter  the  HIGH$  and  LOW$  values. 

Note:  HIGH$  must  be  greater  than  LOW$.  LOW$  is  reset  to  X2FFF'  by  @EXIT, 
©ABORT,  and  @CMNDI. 

Entry  Conditions: 

A=100(X'64') 

B  selects  HIGH$  or  LOW$ 

If  B  =  0,  SVC  deals  with  HIGH$ 

If  B  *  0,  SVC  deals  with  LOW$ 
HL  selects  one  of  the  following  functions: 

If  HL  =  0,  the  current  HIGH$  or  LOW$  is  returned 

If  HL=£0,  then  HIGH$  or  LOW$  is  set  to  the  value  in  HL 

Exit  Conditions: 

Success,  Z  flag  set. 

HL =current  HIGH$  or  LOW$.  If  HL  ^  ©  on  entry,  then  HIGH$  or  LOW$ 
is  now  set  to  that  value. 
Failure,  NZ  flag  set. 

A   =  error  number 

General: 

If  bit  0  of  CFLAG$  is  set  (see  ©FLAGS),  then  HIGH$  cannot  be  changed 
with  this  call.  The  call  returns  error  43,  "SVC  parameter  error!' 

Example: 

See  Sample  Program  F,  lines  75-86. 
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@INIT SVC  Number  58 

Open  or  Initialize  File 

Opens  a  file.  If  the  file  is  not  found,  this  SVC  creates  it  according  to  the  file 
specification. 

Entry  Conditions: 

A   =  58(X'3A) 

HL = pointer  to  256-byte  disk  I/O  buffer 

DE=  pointer  to  FCB  containing  the  file  specification 

B   =  Logical  Record  Length  to  be  used  while  file  i$  open 

Exit  Conditions: 

Success,  Z  flag  set.  File  was  opened  or  created. 

The  CF  flag  is  set  if  a  new  file  was  created. 
Failure,  NZ  flag  set. 

A= error  number 

General: 

Only  AF  is  altered  by  this  SVC. 

The  file  open  bit  is  set  in  the  directory  if  the  access  level  is  UPDATE  or 
greater. 

Example: 

See  Sample  Program  C,  lines  260-272. 
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@IPL SVC  Number  0 

Reboot  the  System 

Ooes  a  software  reset.  Floppy  drive  0  must  contain  a  system  disk.  @IPL  uses 
the  standard  boot  sequence,  the  same  as  for  a  hard  reset  (pressing  the  reset 
button).  Memory  locations  X'41  E5'-X'4225'  and  X'4300'-X'43FF'  are  altered 
during  the  boot  of  the  machine. 

Entry  Conditions: 

A  =  0(X'00') 

General: 

This  SVC  does  not  return. 
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@KBP SVC  Number  8 

Scan  Keyboard  and  Return 

Scans  the  keyboard  and  returns  a  character  if  a  key  is  pressed.  If  no  key  is 
pressed,  a  zero  value  is  returned. 

Entry  Conditions: 

A  =  8(XW) 

Exit  Conditions: 

Success,  Z  flag  set. 

A = character  pressed 
Failure,  NZ  set. 

If  A  =  0,  no  character  was  available. 

If  A  +  0,  then  A  contains  error  number. 

General: 

DE  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  C,  lines  198-200. 


-J 
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@KEY SVC  Number  1 

Scan  *KI  Device,  Wait  for  Character 

Scans  the  *KI  device  and  returns  with  a  character.  It  does  not  return  until  a 
character  is  input  to  the  device. 

Note:  The  system  suspends  execution  of  the  program  that  issued  the  SVC  until 
a  character  can  be  obtained.  Background  tasks  will  continue  to  run  normally. 

Entry  Conditions: 

a=i  (X'or) 

Exit  Conditions: 

Success,  Z  flag  set. 

A  =  character  entered 
Failure,  NZ  flag  set. 

A  =  error  number 

General: 

OE  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  B,  lines  202-203. 


• 
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@KEYIN SVC  Number  9 

Accept  a  Line  of  Input 

Accepts  a  line  of  input  until  terminated  by  either  an  [  enter)  or  a  dBSE).  Entries 
are  displayed  on  the  screen,  starting  at  the  current  cursor  position.  Backspace, 
tab,  and  line  delete  are  supported.  If  JCL  is  active,  the  line  is  fetched  from  the 
active  JCL  file. 

Entry  Conditions: 

A   =9(X'09') 

HL = pointer  to  user  line  buffer  of  length  B  +  1 
B  =  maximum  number  of  characters  to  input 
C  =0 

Exit  Conditions: 

Success,  Z  flag  set. 

H  L = pointer  to  start  of  buffer 

B   =  actual  number  of  characters  input 

CF  is  set  if  (BREAK)  terminated  the  input. 
Failure,  NZ  flag  set. 

A   =  error  number 

General: 

DE  and  C  are  altered  by  this  SVC. 

Example: 

See  Sample  Program  C,  lines  39-47. 
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@KLTSK SVC  Number  32 

Remove  Currently  Executing  Task 

When  called  by  an  executing  task  driver,  removes  the  task  assignment  from  the 
task  table  and  returns  to  the  foreground  application  that  was  interrupted. 

Entry  Conditions: 

A  =  32(X'20') 

General: 

This  SVC  does  not  return. 

Example: 

See  the  example  for  @RMTSK  in  Sample  Program  F,  lines  134-142. 
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(a  LOAD SVC  Number  76 

Load  Program  File 

Loads  a  program  file.  The  file  must  be  in  load  module  format. 

Entry  Conditions: 

A    =76(X'4C) 

DE  =  pointer  to  FCB  containing  filespec  of  the  file  to  load 

Exit  Conditions: 

Success,  Z  flag  set. 

HL= transfer  address  retrieved  from  file 
Failure,  NZ  flag  set. 

A   =  error  number 

Example: 

See  Sample  Program  A,  lines  50-56. 
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@LOC SVC  Number  63 

Calculate  Current  Logical  Record  Number 

Returns  the  current  logical  record  number. 

Entry  Conditions: 

A    =63(X'3F') 

DE  =  pointer  to  the  file's  FCB 

Exit  Conditions: 

Success,  Z  flag  set. 

BC = logical  record  number 
Failure,  NZ  flag  set. 

A    =  error  number 

General: 

AF  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  C,  lines  305-311. 
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@LOF SVC  Number  64 

Calculate  the  EOF  Logical  Record  Number 

Returns  the  EOF  (End  of  File)  logical  record  number. 

Entry  Conditions: 

A    =64{X,40>) 

DE  =  pointer  to  FCB  for  the  file  to  check 

Exit  Conditions: 

Success,  Z  flag  set. 

BC  =  the  EOF  logical  record  number 
Failure,  NZ  flag  set. 

A   =  error  number 

General: 

Only  AF  is  altered  by  this  SVC. 

Example: 

See  the  example  for  @LOC  in  Sample  Program  C,  lines  305-311. 
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@LOGER SVC  Number  11 

Issue  Log  Message 

Issues  a  log  message  to  the  Job  Log.  The  message  can  be  any  character  string 
terminating  with  a  carriage  return  (X'OD'). 

Entry  Conditions: 

A   =  11  (XOB') 

HL = pointer  to  first  character  in  message  line 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

Only  AF  is  altered  by  this  SVC. 

Example: 

LD    HLtTEXT    iPoint  at  message  to  output 
LD    A#@LOGER   tand  output  it  to  the  Job 

!l_D<r 
RST   28H        !Call  the  SLOGER  SVC 

4  4  4 

TEXT:   DEFM   'This  is  a  message  for  the  Job  Lo3' 

DEFB  0DH        tMessatfe  must  be  terminated 
?uith  an  <ENTER>. 


C 
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@LOGOT SVC  Number  12 

Display  and  Log  Message 

Displays  and  logs  a  message.  Performs  the  same  function  as  @DSPLY  fol- 
lowed by  @LOGER. 

Entry  Conditions: 

A   =12{X'0C*) 

HL = pointer  to  first  character  in  message  line 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A= error  number 

General: 

Only  AF  is  altered  by  this  SVC. 

To  avoid  a  looping  condition  that  could  result  from  the  display  device  gen- 
erating an  error,  no  error  checking  should  be  done  after  returning  from 
@LOGOT. 

Example: 

LD    HL fTEXT    tPoint  at  message  to  output 
LD    At@LOGOT   Sand  output  it  to  the  Job 

iLo9  AND  the  display 
RST   28H        JCall  the  SLOGOT  SVC 

♦  »  • 

TEXT:   DEFM   'This  message  will  be  displayed  both  in' 
DEFM   'the  Job  Lo3  and  on  the  display.' 
DEFB  0DH       iMust  terminate  text  with  an 
i< ENTER >. 
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@MSG SVC  Number  13 

Send  Message  to  Device 

Sends  a  message  line  to  any  device  or  file. 

Entry  Conditions: 

A   =13<XW) 

DE= pointer  to  DCB  or  FCB  of  device  or  file  to  receive  output 

HL = pointer  to  message  line  terminated  with  X'W  or  X'03' 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A = error  number 

General: 

Only  AF  is  altered  by  this  SVC. 


Example: 


LD 

HL  fTEXT 

LD 

DE,DCBP 

LD 

A.0MSG 

RST 

ZBH 

iPoint  at  message  to  output 
JPoint  at  the  device  control 
iblocK  for  our  device 
Sand  write  this  text  to  it 
.Call  the  @MSG  SVC 


TEXT:   DEFM   'D555-555<L0GIN  USER>'  iText  to  write  to 

ithis  device.  In  this  case* 
!it  is  a  dialin?  modem. 
DEFB  B3H       ^Terminate  the  message 


C 
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@MUL8 SVC  Number  90 

8-Bit  Multiplication 

Performs  an  8-bit  by  8-bit  unsigned  integer  multiplication.  The  resultant  product 
must  fit  into  an  8-bit  field. 

Entry  Conditions: 

A  =  90(X'5A') 
C= multiplicand 
E  =  multiplier 

Exit  Conditions: 

Success  always. 
A = product 
DE  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  B,  lines  150-153. 


^ 
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@MUL16 SVC  Number  91 

16-Bit  by  8-Bit  Multiplication 

Performs  an  unsigned  integer  multiplication  of  a  16-bit  multiplicand  by  an  8-bit 
multiplier.  The  resultant  product  is  stored  in  a  3-byte  register  field. 

Entry  Conditions: 

A    =  91  (X'5B) 
HL  =  multiplicand 
C   =  multiplier 

Exit  Conditions: 

Success  always. 

HL  =  two  high-order  bytes  of  product 
A   =  low-order  byte  of  product 
DE  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  B,  lines  183-187. 
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@OPEN SVC  Number  59 

Open  Existing  File  or  Device 

Opens  an  existing  file  or  device. 

Entry  Conditions: 

A   =59(X'3B) 

HL  =  pointer  to  256-byte  disk  I/O  buffer 

DE= pointer  to  FCB  or  DCS  containing  filespec  or  devspec 

B   =  logical  record  length  for  open  file 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

AF  is  altered  by  this  SVC. 

The  file  open  bit  is  set  in  the  directory  if  the  access  level  is  UPDATE  or 
greater. 

Example: 

See  Sample  Program  C,  lines  134-150. 
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(a  PAR  AM SVC  Number  17 

Parse  Parameter  String 

Parses  an  optional  parameter  string.  Its  primary  function  is  to  parse  command 
parameters  contained  in  a  command  line  starting  with  a  parenthesis.  The 
acceptable  parameter  format  is: 

PARM  =  X'nnnn'.... hexadecimal  entry 

PARM  =  nnnnn  ....decimal  entry 

PARM  =  "string"  ...alphanumeric  entry 

PARM  =  flag       ....ON,  OFF,  Y,  N,  YES,  or  NO 

Note:  Entering  a  parameter  with  no  equal  sign  or  value  is  the  same  as 
using  PARM  =  ON.  Entering  PARM  =  with  no  value  is  the  same  as 
using  PARM  =  OFF. 

Entry  Conditions: 

A   =17(X'11') 

DE= pointer  to  beginning  of  your  parameter  table 
HL= pointer  to  command  line  to  parse  (the  parameter  string  is  enclosed 
within  parentheses) 

Exit  Conditions: 

Success  always. 

If  Z  is  set,  either  valid  parameters  or  no  parameters  were  found. 
If  NZ  is  set,  a  bad  parameter  was  found. 

General: 

NZ  is  not  returned  if  parameter  types  other  than  those  specified  are 
entered.  The  application  must  check  the  validity  of  the  response  byte. 

The  valid  parameters  are  contained  in  a  user  table  which  must  be  in  one  of  the 
following  formats.  {Parameter  names  must  consist  of  alphanumeric  charac- 
ters, the  first  of  which  is  a  letter.) 

For  use  with  TRSDOS  version  6,  use  this  format: 

The  parameter  table  starts  with  a  single  byte  X'80.'  Each  parameter  is 
stored  in  a  variable  length  field  as  described  below. 

1 )  Type  Byte  (Type  and  length  byte) 
Bit  7 — If  set,  accept  numeric  value 
Bit  6 — If  set,  accept  flag  parameter 
Bit  5 — If  set,  accept  "string"  value 

Bit  4  —  If  set,  accept  first  character  of  name  as  abbreviation 
Bits  3-0 — Length  of  parameter  name 

2)  Actual  Parameter  Name 

3)  Response  byte  {Type  and  length  found) 
Bit  7 — Numeric  value  found 

Bit  6 — Flag  parameter  found 

Bit  5 — String  parameter  found 

Bits  4-0 — Length  of  parameter  entered.  If  length  is  0  and  the  2-byte 
vector  points  to  a  quotation  mark  (X'22'),  then  the  parameter 
was  a  null  string.  Otherwise,  a  length  of  0  indicates  that  the 
parameter  was  longer  than  31  characters. 

4)  2-byte  address  vector  to  receive  the  parsed  parameter  values. 

The  2-byte  memory  area  pointed  to  by  the  address  field  of  your  table 
receives  the  value  of  PARM  if  PARM  is  non-string.  If  a  string  is  entered,  the 
2-byte  memory  area  receives  the  address  of  the  first  byte  of  "string."  The 
entries  ON,  YES,  and  Y  return  a  value  of  X'FFFF;  OFF,  NO,  and  N  return 
X'OOOO'  If  a  parameter  name  is  specified  on  the  command  line  and  is  fol- 
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lowed  by  an  equal  sign  and  no  value,  then  X'0000'  or  NO  is  returned.  If  a 
parameter  name  is  used  on  the  command  line  without  the  equal  sign,  then 
a  value  of  X'FFFF'  or  ON  is  assumed.  For  any  allowed  parameter  that  is 
completely  omitted  on  the  command  line,  the  2-byte  area  remains 
unchanged  and  the  response  byte  is  0. 

The  parameter  table  is  terminated  with  a  single  byte  X'OO.' 

For  compatibility  with  LDOS  5.1.3,  use  this  format: 

A  6-character  "word"  left  justified  and  padded  with  blanks  followed  by  a  2- 
byte  address  to  receive  the  parsed  values.  Repeat  word  and  address  for  as 
many  parameters  as  are  necessary.  You  must  place  a  byte  of  X'00'  at  the 
end  of  the  table. 


Example: 


LD 

HL»C0MAND 

Point 

LD 

DE»PARM 

Point 

LD 

A»@PARAM 

Parse 
cowman 

RST 

28H 

Call  t 

JR 

NZjERROR 

An  err 
inc lud 

LD 

A.(RESP) 

Get  re 

AND 

040H 

Test  r 

JR 

Z.BAD 

User  s 
like  U 
UPDATE 

LD 

AtCVAL) 

Get  Is 

OR 

A 

Test  t 

JR 

ZtOFF 

UPDATE 
specif 

JR 

ON 

UPDATE 
specif 

COMAND: 

*  *  * 

DEFS 

80 

PARM: 

DEFB 
DEFB 

S0H 
40H+6 

RESP: 
VAL: 

DEFM 
DEFB 
DEFU 
DEFB 
DEFS 

'UPDATE' 

0 

VAL 

0 

2 

at  command  buffer 
at  pa  ramete r  list 
the  items  on  the 

id  line 

,he  0PARAM  SVC 

<or  occurred  (not 

led  here) 

>sponse    code 

'espouse    flafls 

ipecified    something 

JPDATE=X'1234'    or 
:  "HELLO" 

►  t  byte  of  VAL  word 

,he  value 
=0FF  or  UPDATE=N0  was 
ied 
=0N  or  UPDATE=YES  was 

'ied 


Area  where  command  is 

stored 

Table  header  code 

40  says  we  want  a  fla? 

(YES/NO).  6  is  length  of 

the  parameter  name 

Parameter  name 

Response  area 

Vector  to  VAL 

End  of  Table  code 

Area  to  receive  a  parameter 

value 
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©PAUSE SVC  Number  16 

Suspend  Program  Execution 

Suspends  program  execution  for  a  specified  period  of  time  and  goes  into  a 
"holding"  state.  The  delay  is  at  least  14.3  microseconds  per  count. 

Entry  Conditions: 

A    =  16(X'10') 
BC  =  delay  count 

Exit  Conditions : 

Success  always. 

Example: 

LD    BC*3GA2H   JWait  for  about  200  milli- 
tseconds.  14.3  usees  * 
313986  is  approx.  200 
?wsecs 
LD    At@PAUSE   .Suspend  execution 
RST   2BH        !Call  the  6PAUSE  SMC 


• 
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@PEOF SVC  Number  65 

Position  to  End  Of  File 

Positions  an  open  file  to  the  End  Record  Number  (ERN).  An  end-of-file- 
encountered  error  (X1C)  is  returned  if  the  operation  is  successful.  Your  pro- 
gram may  ignore  this  error. 

•  Entry  Conditions: 

A    =65(X'41') 
DE = pointer  to  FCB  of  the  file  to  position 

Exit  Conditions: 

NZ  flag  always  set. 

If  A  =  X'1  C;  then  success. 
If  A  *  X1Q*  then  failure. 
A  =  error  number 

General: 

AF  is  always  altered  by  this  SVC. 

Example: 

See  the  example  for  @LOC  in  Sample  Program  C,  lines  305-311. 
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@POSN 


Position  File 


SVC  Number  66 


Positions  a  file  to  a  logical  record.  This  is  useful  for  positioning  to  records  of  a 
random  access  file. 

When  the  @POSN  routine  is  used,  Bit  6  of  FCB+ 1  is  automatically  set.  This 
ensures  that  the  EOF  (End  Of  File)  is  updated  when  the  file  is  closed  only  if  the 
NRN  (Next  Record  Number)  exceeds  the  current  ERN  (End  Record  Number). 

Note  that  @POSN  must  be  used  for  each  write,  even  if  two  records  are  side  by 
side. 

Entry  Conditions: 

A    =  66(X'42') 

DE = pointer  to  FCB  for  the  file  to  position 

BC  =  the  logical  record  number 

Exit  Conditions: 

If  Z  flag  is  set  or  A = X'1  C  or  X'1  D;  then  success. 

The  file  was  positioned. 
Otherwise,  failure. 

A  =  errornttf77oe/' 

General: 

AF  is  always  altered  by  this  SVC. 

Example: 

See  the  example  for  @LOC  in  Sample  Program  C,  lines  305-311. 
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©PRINT SVC  Number  14 

Prints  Message  Line 

Outputs  a  message  line  to  the  printer.  The  line  must  be  terminated  with  either  a 
carriage  return  (X'0D)  or  an  ETX  (X'03'). 

Entry  Conditions: 

A   =14(X'0E') 

HL = pointer  to  message  to  be  output 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

AF  and  DE  are  altered  by  this  SVC. 

Example: 

LD    HLtTEXT    iText  to  be  output  to  the 

jprinte  r 
LD    A»@PRINT   iWrite  this  Message  to  the 

Jprinte  r  device 
RST   28H        iCall  the  6PRINT  SVC 

*  »  * 

TEXT:   DEFB  0CH        !Do  a  Top  of  Form 

DEFM   'Report  continued  Pa3e 

DEFB  3  iTertninate  with  a  <ETX>  or 

5an  <ENTER> 


Software  119 


@PRT SVC  Number  6 

Send  Character  to  Printer 

Outputs  a  byte  to  the  line  printer. 

Entry  Conditions: 

A  =  6(X'06•)  ^^ 

C = character  to  print  fl     A 

Exit  Conditions:  ^^^ 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A = error  number 

General: 

AF  and  DE  are  altered  by  this  SVC. 

If  the  line  printer  is  attached  but  becomes  unavailable  (out  of  paper,  out  of 
ribbon,  turned  off,  off-line,  buffer  full,  etc.),  the  printer  driver  waits  approx- 
imately ten  seconds.  If  the  printer  is  still  not  ready,  a  "Device  not  avail- 
able" error  is  returned. 

Example: 

LD  At(PAGE>  >Get  the  pase  number 

ADD  A»'0'  iMake  it  ASCII 

LD  C»A  SPut  the  ualue  here 

LD  A.@PRT  iWrite  this  character  to  the 

?p  rinte  r 

RST  28H  SCall  the  @PRT  SVC 

+  ♦  * 

PAGE:   DEFB  2  iStart  with  pais  2 
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@PUT SVC  Number  4 

Write  One  Byte  to  Device  or  File 

Outputs  a  byte  to  a  logical  device  or  file.  The  DCB  TYPE  byte  {DCB  +  0,  Bit  1) 
must  permit  PUT  operation. 

Entry  Conditions: 

A    =4{X'04') 

DE = pointer  to  DCB  or  FCB  of  the  output  device 

C    =  byte  to  output 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A = error  number 

General: 

AF  is  always  altered  by  this  SVC. 

Example: 

See  the  section  "Device  Driver  and  Filter  Templates!' 


'mOtr 
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(gRAMDIR SVC  Number  35 

Get  Directory  Record  or  Free  Space 

Reads  the  directory  information  of  visible  files  from  a  disk  directory,  or  gets  the 
amount  of  free  space  on  a  disk. 

Entry  Conditions: 

A   =35(X'23') 

HL = pointer  to  RAM  buffer  to  receive  information 

B   =  logical  drive  number  (0-7) 

C      selects  one  of  the  following  functions: 

If  C  =  0,  get  directory  records  of  all  visible  files. 

If  C = 255,  get  free  space  information. 

If  C  =  1-254,  get  a  single  directory  record  (see  below). 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

Each  directory  record  requires  22  bytes  of  space  in  the  buffer.  If  C  =  0,  one  addi- 
tional byte  is  needed  to  mark  the  end  of  the  buffer. 

For  single  directory  records,  the  number  in  the  C  register  should  be  one  less 
than  the  desired  directory  record.  For  example,  if  C  =  1,  directory  record  2  is 
fetched  and  put  in  the  buffer.  If  a  single  record  request  is  for  an  inactive  record 
or  an  invisible  file,  the  A  register  returns  an  error  code  25  (File  access  denied). 

The  directory  information  is  placed  in  the  buffer  as  follows: 

Byte       Contents 

00-14  filename/ext:d  (left  justified,  padded  with  spaces) 

1 5  protection  level,  0  to  6 

16  EOF  offset  byte 

17  logical  record  length,  0  to  255 
18-19  ERNoffile 

20-21      file  size  in  K  (1 024-byte  blocks) 

22  LAST  RECORD  ONLY.  Contains  "  +  "  to  mark  buffer  end. 

If  C  =  255,  HL  should  point  to  a  4-byte  buffer.  Upon  return,  the  buffer  contains: 

Bytes  00-01     Space  in  use  in  K,  stored  LSB,  MSB 
Bytes  02-03    Space  available  in  K,  stored  LSB,  MSB 

Example: 

See  the  example  for  @DODIR  in  Sample  Program  E,  lines  32-40. 
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@RDHDR SVC  Number  48 

Read  a  Sector  Header 

Reads  the  next  ID  header  when  supported  by  the  controller  driver.  The  floppy 
disk  driver  supplied  treats  this  as  a  @RDSEC  (SVC  49). 

Entry  Conditions: 

A   =48(X'30') 

HL = pointer  to  buffer  to  receive  the  data 

D  =  cylinder  to  read 

C  =  logical  drive  number 

E   =  sector  to  read 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A= error  number 

Example: 

See  the  example  for  @RDSEC  in  Sample  Program  D,  lines  63-66. 
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@RDSEC  SVC  Number  49 


Read  Sector 


Transfers  a  sector  of  data  from  the  disk  to  your  buffer. 

Entry  Conditions: 

A    =49(X'3t) 

HL = pointer  to  the  buffer  to  receive  the  sector 

D  =  cylinder  to  read 

E   =  sector  to  read 

C   =  logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

Only  AF  is  altered  by  this  SVC 

Example: 

See  Sample  Program  D,  lines  63-66. 
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@RDSSC SVC  Number  85 

Read  System  Sector 

Reads  the  specified  system  (directory)  sector.  If  the  cylinder  number  in  register 
D  is  not  the  directory  cylinder,  the  value  in  D  is  changed  to  reflect  the  real  direc- 
tory cylinder  and  the  sector  is  then  read. 

Entry  Conditions: 

A   =85(X'55') 

HL = pointer  to  the  buffer  to  receive  the  sector 

D  -cylinder  to  read 

E   =  sector  to  read 

C   =  logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

Only  AF  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  D,  lines  78-92. 
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@RDTRK  SVC  Number  51 


Read  a  Track 


Reads  an  entire  track  when  supported  by  the  controller  driver.  The  floppy  disk 
driver  supplied  treats  this  as  a  @RDSEC  (SVC  49)  and  does  not  do  a  track 
read. 

Entry  Conditions: 

A    =51(X'33') 

HL = pointer  to  buffer  to  receive  the  sector 

D  =  track  to  read 

C  =  logical  drive  number 

E   =  sector  to  read 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

AF  is  altered  by  the  supplied  floppy  disk  driver. 

Example: 

See  the  example  for  @RDSEC  in  Sample  Program  D,  lines  63-66. 
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@READ  SVC  Number  67 


Read  a  Record 


9 


Reads  a  logical  record  from  a  file.  If  the  LRL  defined  at  open  time  was  256 
(specified  by  0),  then  the  NRN  sector  is  transferred  to  the  buffer  established  at 
open  time.  For  LRL  between  1  and  255,  the  next  logical  record  is  placed  into  a 
user  record  buffer,  UREC.  The  3-byte  NRN  is  updated  after  the  read  operation. 

Entry  Conditions: 

A   =67(X'43') 

DE= pointer  to  FCB  for  the  file  to  read 

HL=pointerto  user  record  buffer  UREC  (needed  if  LRL=  1-255;  unused  if 
LRL  =  256) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

Example: 

See  Sample  Program  C,  lines  300-304. 
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@REMOV  SVC  Number  57 


Remove  File  or  Device 


Removes  a  file  or  device. 

If  a  file  is  to  be  removed,  the  File  Control  Block  must  be  in  an  open  condition. 
When  this  SVC  is  performed,  the  file's  directory  is  updated  and  the  space  occu- 
pied by  the  file  is  deallocated. 

If  a  device  was  specified,  the  device  is  closed.  To  remove  a  device,  use  the 
REMOVE  library  command. 

Entry  Conditions: 

A    =57(X'39*) 

DE = pointer  to  FCB  or  DCB  to  remove 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A= error  number 

Example: 

See  Sample  Program  C,  lines  223-231. 
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@RENAM 


SVC  Number  56 


Rename  File  or  Device 


i 


Changes  a  file's  filename  and/or  extension. 

Entry  Conditions: 

A    =  56(X'38') 

DE = pointer  to  an  FCB  containing  the  file's  current  name 

This  FCB  must  be  in  a  closed  state. 
HL=pointer  to  new  filename  string  terminated  with  a  X'0D'  or  X'03.'  This 

filespec  must  be  in  upper  case  and  must  be  a  valid  filespec.  You  can 

convert  the  filespec  to  upper  case  and  check  its  validity  by  using  the 

@FSPEC  SVC  before  using  @RENAM. 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

After  the  call  is  completed,  the  FCB  pointed  to  by  DE  is  altered. 
Only  AF  is  altered  by  this  SVC. 


Example: 

LD 

DE#FCB 

LD 

HL.NEW 

LD 

A»@RENAM 

RST 

28H 

*     *     » 

FCB:     DEFS 

32 

**<ar 


NEW:  DEFM  'NEWNAME/TXT 
DEFB  0DH 


closed  FCB 
the  old 


new  filespec 


JPoint  at  a 

i  con  tainin  «f 

!f i lespec 

iPoint  to  the 

i to  use 

SChande  the  name  of  the 

if  ile 

iCall  the  SRENAM  SVC 

»A  File  Control  BlocK  used 
iby  the  @RENAM  SVC,  In 
? this  example  *  it  is 
iassumed  that  an  SFSPEC 
5SVC  has  loaded  a  filespec 
linto  the  FCB  before  the 
iSRENAM  SVC  is  performed. 
5The  new  filespec  for  the 
jf  ile 
(Terminate  the  filespec 
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@REW SVC  Number  68 

Rewind  File  to  Beginning 

Rewinds  a  file  to  its  beginning  and  resets  the  3-byte  NRN  to  0.  The  next  record 
to  be  read  or  written  sequentially  is  the  first  record  of  the  file. 

Entry  Conditions: 

A    =68(X'44') 

DE  =  pointer  to  FCB  tor  the  file  to  rewind 

Exit  Conditions: 

Success,  Z  flag  set.  File  positioned  to  record  number  0. 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

AF  is  always  altered  by  this  SVC. 

Example: 

See  the  example  for  @LOC  in  Sample  Program  C,  lines  305-311. 
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@RMTSK SVC  Number  30 

Remove  Interrupt  Level  Task 

Removes  an  interrupt  level  task  from  the  Task  Control  Block  table. 

Entry  Conditions: 

A  =  30(X'1E') 

C = task  slot  assignment  to  remove  (0-11) 

Exit  Conditions: 

Success  always. 

HL  and  DE  are  altered  by  this  SVC. 

Example: 

See  Sample  Program  F-  lines  134-142. 
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@RPTSK SVC  Number  31 

Replace  Task  Vector 

Exits  the  task  process  executing  and  replaces  the  currently  executing  task's 
vector  address  in  the  Task  Control  Block  table  with  the  address  following  the 
SVC  instruction.  Return  is  made  to  the  foreground  application  that  was 
interrupted. 

Entry  Conditions: 

A  =  31  (X'1F) 

General: 

This  SVC  does  not  return. 

Example: 

LD    A»RPTSK  SReplace  this  task  with  the 
5one  located  at  the 
SfollowinS  address: 

RST   28H      iCall  the  6RPTSK  SVC 
NEWADD:  DEFW  0        iAddress  of  the  new  task  is 

iloaded  heret  This  word 
lrrtust  be  immediately  after 
ithe  SRPTSK  SVC.  The  label 
iNEWADD  is  present  only  to 
Sallow  the  address  to  be 
^stored • 
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@RREAD  SVC  Number  69 


Reread  Sector 


Forces  a  reread  of  the  current  sector  to  occur  before  the  next  I/O  request  is  per- 
formed. Its  most  probable  use  is  in  applications  that  reuse  the  disk  I/O  buffer  for 
multiple  files,  to  make  sure  that  the  buffer  contains  the  proper  file  sector.  This 
routine  is  valid  only  for  byte  I/O  or  blocked  files.  Do  not  use  it  when  positioned 
at  the  start  of  a  file. 

Entry  Conditions: 

A    =69{X'45') 

DE = pointer  to  FCB  for  the  file  to  reread 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A=erro/-m//noer 

General: 

AF  is  always  altered  by  this  SVC. 

Example: 

LD    DE»FCB     (Point  to  File  Control  Block 
iof  the  file  that  requires 
5the  re-read 

LD    A»@RREAD   iBefore  next  I/O*  reload 
5the  current  sector  into 
!the  system  buffer  for 
ithis  file 

RST   28H       ;Call  the  @RREAD  SVC 
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@RSLCT SVC  Number  47 

Test  for  Drive  Busy 

Performs  a  test  of  the  last  selected  drive  to  see  if  it  is  in  a  busy  state.  If  busy,  it 
is  re-selected  until  it  is  no  longer  busy. 

Entry  Conditions: 

A  =  47(X'2F) 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success  always. 

Only  AF  is  altered  by  this  SVC. 

Example: 

LD    C»l        iTest  Drive  1  to  see  if  it 

Sis  busy. 
LD    A tSRSLCT   ilf  it  is»  continue 

•  select ins  it 
RST   28H        .Call  the  ©RSLCT  SVC 
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@RSTOR SVC  Number  44 

Issue  FDC  RESTORE  Command 

Issues  a  disk  controller  RESTORE  command. 

Entry  Conditions: 

A  =  44(X'2C) 

C- logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A= error  number 

Example: 

See  the  example  for  @CKDRV  in  Sample  Program  D,  lines  38-39. 
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@RUN SVC  Number  77 

Run  Program 

Loads  and  executes  a  program  file.  If  an  error  occurs  during  the  load,  the  sys- 
tem prints  the  appropriate  message  and  returns. 

Entry  Conditions: 

A    =77(X'4D') 

DE = pointer  to  FCB  containing  the  fiiespec  of  the  file  to  RUN 

Note:  The  FCB  must  be  located  where  the  program  being  loaded  will  not 

overwrite  it. 

Exit  Conditions: 

Success,  the  new  program  is  loaded  and  executed. 

Failure,  the  error  is  displayed  and  return  is  made  to  your  program. 

HL = return  code  (See  the  section  "Converting  to  TRSDOS  Version  6" 
for  information  on  return  codes.) 

General: 

HL  is  returned  unchanged  if  no  error  occurred  and  can  be  used  as  a 
pointer  to  a  command  line. 

Example: 

See  Sample  Program  A,  lines  62-74. 
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@RWRIT  SVC  Number  70 


Rewrite  Sector 


Rewrites  the  current  sector,  following  a  write  operation.  The  ©WRITE  function 
advances  the  NRN  after  the  sector  is  written.  @RWRIT  decrements  the  NRN 
and  writes  the  disk  buffer  again.  Do  not  use  @RWRIT  when  positioned  to  the 
start  of  a  file. 

Entry  Conditions: 

A    =70(X'46') 

DE = pointer  to  FCB  for  the  file  to  rewrite 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

Example: 

LD    DE»FCB     iPoint  to  the  File  Control 

iBIock 
LD    A»@RWRIT   .Perform  a  re-write  of  the 

■current  sector 
RST   Z8H        iCall  the  iRWRIT  SVC 
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@SEEK SVC  Number  46 

Seek  a  Cylinder 

Seeks  a  specified  cylinder  and  sector.  ©SEEK  does  not  return  an  error  if  you 
specified  a  non-existent  drive  or  an  invalid  cylinder,  @SEEK  performs  no  action 
if  the  specified  drive  is  a  hard  disk. 

Note:  Seek  of  a  sector  is  not  supported  by  TRS-80  hardware.  An  implied  seek 
is  included  in  sector  reads  and  writes. 

Entry  Conditions: 

A=46(X'2E') 
C = logical  drive  number 
D= cylinder  to  seek 
E= sector  to  seek 

Exit  Conditions: 

Success  always. 

Only  AF  is  altered  by  this  SVC. 
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@SEEKSC SVC  Number  71 

Seek  Cylinder  and  Sector 

Seeks  the  cylinder  and  sector  corresponding  to  the  next  record  of  the  specified 
fite.  (This  is  done  by  examining  the  NRN  field  of  the  FCB.)  No  error  is  returned 
on  physical  seek  errors. 

Entry  Conditions: 

A    =71  (X'47') 

DE = pointer  to  the  file's  FCB 

Exit  Conditions: 

Success  always. 

Example: 

LD    DEfFCB     iPoint  to  the  File  Control 

;biock 

LD    A>@SEEKSC  iCause  the  next  sector  to  be 
iSEEKed  before  it  is 
factually  needed 

RST   28H       iCall  the  0SEEKSC  SUC 
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@SKIP SVC  Number  72 

Skip  a  Record 

Causes  a  skip  past  the  next  logical  record.  Only  the  record  number  contained 
in  the  FCB  is  changed;  no  physical  I/O  takes  place. 

Entry  Conditions: 

A    =72(X'48') 

DE  -pointer  to  FCB  for  the  file  to  skip 

Exit  Conditions: 

If  the  Z  flag  is  set  or  if  A = X'1  C  or  X'1  D,'  then  the  operation  was  successful. 
Otherwise,  A  =  error  number.  If  A  =  X'1C  is  returned,  the  file  pointer  is 
positioned  at  the  end  of  the  file.  Any  Appending  operations  would  be 
performed  here.  If  A  =  X'1  D'  is  returned,  the  file  pointer  is  positioned 
beyond  the  end  of  the  file. 

General: 

AF  is  altered  by  this  SVC. 

BC  contains  the  current  record  number.  This  is  the  same  value  as  that 
returned  by  the  @LOC  SVC. 

Example: 

See  the  example  for  @LOC  in  Sample  Program  C,  lines  305-311. 
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@SLCT  SVC  Number  41 


Select  a  New  Drive 


i 


Selects  a  drive.  The  time  delay  specified  in  your  configuration  (SYSTEM 
(DELAY  =  Y/N))  is  made  if  the  drive  selection  requires  it. 

Entry  Conditions: 

A  =  41  (X'29') 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A = error  number 

General: 

Only  AF  is  altered  by  this  SVC. 
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©SOUND  SVC  Number  104 


Sound  Generation 


Generates  sound  using  specified  tone  and  duration  codes.  Interrupts  are  dis- 
abled during  execution. 

Entry  Conditions: 

A  =  104(X'68') 

B  =  function  code 

bits  0-2:  tone  selection  (0-7  with  0= highest  and  7  =  lowest) 
bits  3-7:  tone  duration  (0-31  with  0  =  shortest  and  31  =  longest) 

Exit  Conditions: 

Success  always. 

Only  AF  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  B,  lines  43-45. 
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@STEPI SVC  Number  45 

Issue  FDC  STEP  IN  Command 

Issues  a  disk  controller  STEP  IN  command.  This  moves  the  drive  head  to  the 
next  higher-numbered  cylinder.  @STEPI  is  intended  for  sequential  read/write 
operations,  such  as  disk  formatting. 

Entry  Conditions: 

A  =  45(X'2D) 

C= logical  drive  number 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A = error  number 

General: 

Only  AF  is  altered  by  this  SVC. 
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@TIME  SVC  Number  19 


Get  Time 


Gets  the  system  time  in  display  format  (HH:MM:SS). 

Entry  Conditions: 

A   =19(X'13') 

HL  =  pointer  to  buffer  to  receive  the  time  string 

Exit  Conditions: 

Success  always. 

H  L = pointer  to  the  end  of  buffer  + 1 

DE= pointer  to  start  of  TIMES  storage  area  in  TRSDOS 

AF  and  BC  are  altered  by  this  SVC. 

Example: 

See  the  example  for  @DATE  in  Sample  Program  F,  lines  252-253. 
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@VDCTL  SVC  Number  15 


Video  Functions 


§ 


Performs  various  functions  related  to  the  video  display.  The  B  register  is  used 
to  pass  the  function  number. 

Entry  Conditions: 

A  =  15(X'0F') 

B    selects  one  of  the  following  functions: 

If  B  =  1,  return  the  character  at  the  screen  position  specified  by  HL. 
H= row  on  the  screen  (0-23),  where  0  is  the  top  row 
L  =  column  on  the  screen  (0-79),  where  ©  is  the  leftmost  column 

If  B=2,  display  the  specified  character  at  the  position  specified  by 
HL. 
C = character  to  be  displayed 
H=row  on  the  screen  (0-23),  where  0  is  the  top  row 
L  =  column  on  the  screen  (0-79),  where  0  is  the  leftmost  column 

If  B  =  3,  move  the  cursor  to  the  position  specified  by  HL.  This  is  done 
even  if  the  cursor  is  not  currently  displayed. 
H=row  on  the  screen  (0-23),  where  0  is  the  top  row 
L  =  column  on  the  screen  (0-79),  where  0  is  the  leftmost  column 

If  B =4,  return  the  current  position  of  the  cursor. 

If  B  =  5,  move  a  1 920-byte  block  of  data  to  video  memory. 
HL = pointer  to  1 920-byte  buffer  to  move  to  video  memory 

If  B  =  6,  move  a  1 920-byte  block  of  data  from  video  memory  to  a 
buffer  you  supply.  In  40  line  by  24  character  mode,  there  must 
be  a  character  in  each  alternating  byte  for  proper  display. 
HL = pointer  to  1 920-byte  buffer  to  store  copy  of  video  memory  HL 
must  be  in  the  range X23FF'  <  HL  <  X'ECOI . 

If  B  =  7,  scroll  protect  the  specified  number  of  lines  from  the  top  of  the 
^j^  screen. 

C= number  of  lines  to  scroll  protect  (0-7).  Once  set,  scroll  protect 
can  be  removed  only  by  executing  @VDCTL  with  B  =  7  and 
C  =  0,  or  by  resetting  the  system.  Clearing  the  screen  with 
SKEDQSHS)  erases  the  data  in  the  scroll  protect  area,  but  the 
scroll  protect  still  exists. 

If  B  =  8,  change  cursor  character  to  specified  character.  If  the  cursor 
is  currently  not  displayed,  the  character  is  accepted  anyway 
and  is  used  as  the  cursor  character  when  it  is  turned  back  on. 
The  default  cursor  character  is  an  underscore  (X'5F*)  under 
Version  6.2  and  a  X'B0*  under  previous  versions. 
C= character  to  use  as  the  cursor  character 

If  B  =  9,  (under  Version  6.2  only)  transfer  80  characters  to  or  from 
the  screen. 
If  C  =  0,  move  characters  from  the  buffer  to  the  screen 
If  C  =  1 ,  move  characters  from  the  screen  to  the  buffer 
H = row  on  the  screen 
DE = pointer  to  S0  byte  buffer 

Note:  The  video  RAM  area  in  the  Models  4  and  4P  is  2048  bytes  (2K). 
The  first  1920  bytes  can  be  displayed.  The  remaining  bytes  contain  the 
type-ahead  buffer  and  other  system  buffers. 
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Exit  Conditions: 
If  B=1: 

Success,  Z  flag  set. 

A  =  character  found  at  the  location  specified  by  HL 

DE  is  altered. 
Failure,  NZ  flag  set. 

A  =  error  number 

If  B  =  2: 

Success,  Z  flag  set. 

DE  is  altered. 
Failure,  NZ  flag  set. 

A  =  error  number 

lfB=3: 

Success,  Z  flag  set. 

DE  and  HL  are  altered. 
Failure,  NZ  flag  set. 

A  =  error  number 

lfB  =  4: 

Success  always. 

HL=roiv  and  column  position  of  the  cursor.  H  =  row  on  the 
screen  (0-23),  where  0  is  the  top  row;  L  =  column  on  the 
screen  (0-79),  where  0  is  the  leftmost  column. 

If  B  =  5: 

Success  always. 

HL= pointer  to  the  last  byte  moved  to  the  video  + 1 
BC  and  DE  are  altered. 

If  B  =  6: 

Success  always. 

BC,  DE,  and  HL  are  altered. 

If  B  =  7: 

Success  always. 

BC  and  DE  are  altered. 

If  B  =  8: 

Success  always. 

A = previous  cursor  character 
DE  is  altered. 

If  B  =  9  (under  Version  6.2  only): 
Success,  Z  flag  set. 

BC,  HL,  DE  are  altered. 
Failure,  NZ  flag  set  because  H  is  out  of  range. 
A=  error  code  43  (X'2B'). 

General: 

Functions  5, 6,  and  7  do  not  do  range  checking  on  the  entry  parameters. 
If  HL  is  not  in  the  valid  range  in  functions  5  and  6,  the  results  may  be 

unpredictable. 
Only  function  3  (B  =  3)  moves  the  cursor. 
If  C  is  greater  than  7  in  function  7,  it  is  treated  as  modulo  8. 
AF  and  B  are  altered  by  this  SVC. 

Example: 

See  Sample  Program  F,  lines  304-327. 


• 


o 
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@VER SVC  Number  73 

Write  and  Verify  a  Record 

Performs  a  ©WRITE  operation  followed  by  a  test  read  of  the  sector  (if  the  write 
required  physical  I/O)  to  verify  that  it  is  readable. 

If  the  logical  record  length  is  less  than  256,  then  the  logical  record  in  the  user 
buffer  UREC  is  transferred  to  the  file.  If  the  LRL  is  equal  to  256,  a  full  sector 
write  is  made  using  the  disk  I/O  buffer  identified  at  file  open  time. 

Entry  Conditions: 

A    =73(X'49) 

DE = pointer  to  FCB  for  the  file  to  verify 

Exit  Conditions: 

Success,  Z  flag  set. 

HL = pointer  to  user  buffer  containing  the  logical  record 
Failure,  NZ  flag  set. 

A   =  error  number 

General: 

Only  AF  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  C,  lines  338-346. 
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@VRSEC SVC  Number  50 

Verify  Sector 

Verifies  a  sector  without  transferring  any  data  from  disk. 

Entry  Conditions: 

A  =  50(X'32') 

D=  cylinder  to  verify 

E= sector  to  verify 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set 
A = error  number 

General: 

AF  is  always  altered  by  this  SVC. 

If  the  sector  is  a  system  sector,  the  sector  is  readable  if  an  error  6  is 
returned;  any  other  error  number  signifies  an  error  has  occurred. 

Example: 

See  the  example  for  @WRSEC  in  Sample  Program  D,  lines  68-76. 


O 
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@ WEOF  SVC  Number  74 


Write  End  Of  File 


i 


Forces  the  system  to  update  the  directory  entry  with  the  current  end-oMile 
information. 

Entry  Conditions: 

A    =74(X,4A') 

DE = pointer  to  the  FCB  for  the  file  to  WEOF 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A = error  number 

General: 

AF  is  always  altered  by  this  SVC. 

Example: 

LD  DEtFCB  iPoint    at    the    File    Control 

iBlocK 
LD  A*@WEOF        SForce    the    directory    entry 

Ho    be    updated    now* 

iinstead  of  when  the  file 

5  is  closed 
RST   28H        ;Call  the  6WE0F  SVC 
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@WHERE SVC  Number  7 

Locate  Origin  of  SVC 


Used  to  resolve  the  relocation  address  of  the  calling  routine. 

Entry  Conditions: 

A  =  7(X'07') 

Exit  Conditions: 

Success  always. 

HL = pointer  to  address  following  RST28H  instruction 
AF  is  always  altered  by  this  SVC. 

Example: 

See  Sample  Program  F  lines  36-60. 
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©WRITE 


SVC  Number  75 


Write  a  Record 


Causes  a  write  to  the  next  record  identified  in  the  File  Control  Block. 

If  the  logical  record  length  is  less  than  256,  then  the  logical  record  in  the  user 
buffer  UREC  is  transferred  to  the  file.  If  the  LRL  is  equal  to  256,  a  full  sector 
write  is  made  using  the  disk  I/O  buffer  identified  at  file  open  time. 

Entry  Conditions: 

A   =75{X'4B') 

HL = pointer  to  user  record  buffer  UREC  (unused  if  LRL = 256) 

DE= pointer  to  FCB  for  the  file  to  write 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

AF  is  always  altered  by  this  SVC. 

Example: 

See  the  example  for  @VER  in  Sample  Program  C,  lines  338-346. 
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@  WRSEC  SVC  Number  53 


Write  a  Sector 


Writes  a  sector  to  the  disk. 

Entry  Conditions: 

A    =53{X'35') 

HL = pointer  to  the  buffer  containing  the  sector  of  data 

D  =  cylinder  to  write 

E   =  sector  to  write 

C  =  logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A= error  number 

General: 

Only  AF  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  D,  lines  68-76. 


/""*\ 
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@WRSSC SVC  Number  54 

Write  a  System  Sector 

Writes  a  system  sector  (used  in  directory  cylinder). 

Entry  Conditions: 

A   =54{X'36') 

HL = pointer  to  the  buffer  containing  the  sector  of  data 

D   =  cylinder  to  write 

E   =  sector  to  write 

C  = logical  drive  number 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

Only  AF  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  D,  lines  94-104. 
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@WRTRK  SVC  Number  55 


Write  a  Track 


Writes  an  entire  track  of  properly  formatted  data.  The  data  format  must  conform 
to  that  described  in  the  disk  controller's  reference  manual.  @WRTRK  must 
always  be  preceded  by  @SLCT. 

Entry  Conditions: 

A    =55(X'37') 

HL = pointer  to  format  data 

D   =  track  to  write 

C  =  logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

Only  AF  is  altered  by  this  SVC. 


s 
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Numerical  List  of  SVCs 


Following  is  a  numerical  list  of  the  SVCs: 
Dec         Hex  Label 


0 

00 

@IPL 

1 

01 

@KEY 

2 

02 

@DSP 

3 

03 

@GET 

4 

04 

@PUT 

5 

05 

@CTL 

6 

06 

@PRT 

7 

07 

©WHERE 

8 

08 

@KBD 

9 

09 

@KEYIN 

10 

0A 

@DSPLY 

11 

0B 

@LOGER 

12 

0C 

@LOGOT 

13 

0D 

@MSG 

14 

0E 

©PRINT 

15 

0F 

@VDCTL 

16 

10 

©PAUSE 

17 

11 

©PARAM 

18 

12 

©DATE 

19 

13 

©TIME 

20 

14 

©CHNIO 

21 

15 

©ABORT 

22 

16 

©EXIT 

23 

24 

18 

©CMNDI 

25 

19 

©CMNDR 

26 

1A 

©ERROR 

27 

1B 

©DEBUG 

28 

1C 

©CKTSK 

29 

1D 

©ADTSK 

30 

1E 

©RMTSK 

31 

1F 

©RPTSK 

32 

20 

©KLTSK 

33 

21 

©CKDRV 

34 

22 

©DODIR 

35 

23 

©RAMDIR 

3-39 

40 

28 

©DCSTAT 

41 

29 

©SLCT 

42 

2A 

©DCINIT 

43 

2B 

©DCRES 

44 

2C 

©RSTOR 

45 

2D 

©STEPI 
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Function 

Reboot  the  system 
Scan  *KI  device,  wait  for  character 
Display  character  at  cursor,  advance 
cursor 

Get  one  byte  from  a  logical  device 
Write  one  byte  to  a  logical  device 
Make  a  control  request  to  a  logical 
device 

Send  character  to  the  line  printer 
Locate  origin  of  CALL 
Scan  keyboard  and  return 
Accept  a  line  of  input 
Display  a  message  line 
Issue  a  log  message 
Display  and  log  a  message 
Message  line  handler 
Print  a  message  line 
Position/locate  cursor,  get/put  char- 
acter at  cursor 
Suspend  program  execution 
Parse  an  optional  parameter  string 
Get  system  date  in  the  format  MM/ 
DD/YY 

Get  system  time  in  the  format 
HH:MM:SS 

Pass  control  to  the  next  module  in  a 
device  chain 

Load  HL  with  X'FFFF'  error  and  goto 
©EXIT 

Exit  program  and  return  to  TRSDOS 
Reserved  for  future  use 
Entry  to  command  interpreter  with 
return  to  the  system 
Entry  to  command  interpreter  with 
return  to  the  user 
Entry  to  post  an  error  message 
Enter  DEBUG 
Check  if  task  slot  in  use 
Add  an  interrupt  level  task 
Remove  an  interrupt  level  task 
Replace  the  currently  executing  task 
vector 

Remove  the  currently  executing  task 
Check  for  drive  availability 
Do  a  directory  display/buffer 
Get  directory  record(s)  or  free  space 
into  RAM 

Reserved  for  future  use 
Test  if  drive  is  assigned  in  DCT 
Select  a  new  drive 
Initialize  the  FDC 
Reset  the  FDC 

Issue  FDC  RESTORE  command 
Issue  FDC  STEP  IN  command 


Dec 


Hex 


Label 


Function 


46 

2E 

©SEEK 

47 

2F 

@RSLCT 

48 

30 

@RDHDR 

49 

31 

@RDSEC 

50 

32 

@VRSEC 

51 

33 

@RDTRK 

52 

34 

@HDFMT 

53 

35 

@WRSEC 

54 

36 

@WRSSC 

55 

37 

@WRTRK 

56 

38 

@RENAM 

57 

39 

@REMOV 

58 

3A 

@INIT 

59 

3B 

©OPEN 

60 

3C 

©CLOSE 

61 

3D 

@BKSP 

62 

3E 

@CKEOF 

63 

3F 

@LOC 

64 

40 

@LOF 

65 

41 

@PEOF 

66 

42 

@POSN 

67 

43 

©READ 

68 

44 

@REW 

69 

45 

©RREAD 

70 

46 

©RWRIT 

71 

47 

©SEEKSC 

72 

48 

©SKIP 

73 

49 

©VER 

74 

4A 

©WEOF 

75 

4B 

©WRITE 

76 

4C 

©LOAD 

77 

4D 

©RUN 

78 

4E 

©FSPEC 

79 

4F 

©FEXT 

80 

50 

©FNAME 

81 

51 

©GTDCT 

82 

52 

©GTDCB 

83 

53 

©GTMOD 

84 

85 

55 

©RDSSC 

86 

87 

57 

©DIRRD 

88 

58 

©DIRWR 

89 

90 

5A 

©MUL8 

91 

5B 

©MUL16 

92 

93 

5D 

©DIV8 

94 

5E 

©DIV16 

95 

96 

60 

©DECHEX 

97 

61 

©HEXDEC 

Seek  a  cylinder 

Test  if  requested  drive  is  busy 

Read  a  sector  header 

Read  a  sector 

Verify  a  sector 

Read  a  track 

Hard  disk  format 

Write  a  sector 

Write  a  system  sector 

Write  a  track 

Rename  a  file 

Remove  a  file  or  device 

Open  or  initialize  a  file  or  device 

Open  an  existing  file  or  device 

Close  a  file  or  device 

Backspace  one  logical  record 

Check  for  end  of  file 

Calculate  the  current  logical  record 

number 

Calculate  the  EOF  logical  record 

number 

Position  to  the  end  of  file 

Position  a  file  to  a  logical  record 

Read  a  record  from  a  file 

Rewind  a  file  to  its  beginning 

Reread  the  current  sector 

Rewrite  the  current  sector 

Seek  a  specified  cylinder  and  sector 

Skip  the  next  record 

Write  a  record  to  a  file  and  verify 

Write  end  of  file 

Write  a  record  to  a  file 

Load  a  program  file 

Load  and  execute  a  program  file 

Fetch  a  file  or  device  specification 

Set  up  a  default  file  extension 

Fetch  filename/extension  from 

directory 

Get  Drive  Code  Table  address 

Find  specified  or  first  free  DCB 

Find  specified  memory  module 

address 

Reserved  for  future  use 

Read  a  system  sector 

Reserved  for  future  use 

Read  directory  record 

Write  directory  record 

Reserved  for  future  use 

Multiply  8-bit  unsigned  integers 

Multiply  16-bit  by  8-bit  unsigned 

integers 

Reserved  for  future  use 

Divide  8-bit  unsigned  integers 

Divide  16-bit  by  8-bit  unsigned 

integers 

Reserved  for  future  use 

Convert  decimal  ASCII  to  16-bit 

binary  value 

Convert  a  number  in  HL  to  decimal 

ASCII 


• 
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Dec 


Hex 


Label 


Function 


98 
99 

100 

62 
63 
64 

@HEX8 

@HEX16 

@HIGH$ 

101 
102 

65 
66 

©FLAGS 
@BANK 

103 

104 

05-127 

67 
68 

@BREAK 
©SOUND 

Convert  a  1-byte  number  to  hex  ASCII 
Convert  a  2-byte  number  to  hex  ASCII 
Obtain  or  set  the  highest  and  lowest 
unused  RAM  addresses 
Point  IY  to  the  system  flag  table 
Check,  set,  or  reset  a  32K  bank  of 
memory 

Set  user  or  system  break  vector 
Generate  sound  (tone  and  duration) 
Reserved  for  future  use. 


*~ml*r 
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Alphabetical  List  of  SVCs 


Following  is  an  alphabetical  list  of  the  SVC  labels  and  numbers: 

Label  Dec  Hex 


©ABORT 

21 

15 

@ADTSK 

29 

1D 

©BANK 

102 

66 

@BKSP 

61 

3D 

©BREAK 

103 

67 

@CHNIO 

20 

14 

@CKDRV 

33 

21 

@CKEOF 

62 

3E 

@CKTSK 

28 

1C 

©CLOSE 

60 

3C 

©CMNDI 

24 

18 

©CMNDR 

25 

19 

©CTL 

5 

5 

©DATE 

18 

12 

©DCINIT 

42 

2A 

©DCRES 

43 

2B 

©DCSTAT 

40 

28 

©DEBUG 

27 

1B 

©DECHEX 

96 

60 

©DIRRD 

87 

57 

©DIRWR 

88 

58 

©DIV8 

93 

5D 

©DIV16 

94 

5E 

©DODIR 

34 

22 

©DSP 

2 

2 

©DSPLY 

10 

0A 

©ERROR 

26 

1A 

©EXIT 

22 

16 

©FEXT 

79 

4F 

©FLAGS 

101 

65 

©FNAME 

80 

50 

©FSPEC 

78 

4E 

©GET 

3 

3 

©GTDCB 

82 

52 

©GTDCT 

81 

51 

©GTMOD 

83 

53 

©HDFMT 

52 

34 

©HEXDEC 

97 

61 

©HEX8 

98 

62 

©HEX16 

99 

63 

@HIGH$ 

100 

64 

©INIT 

58 

3A 

@IPL 

0 

0 

©KBD 

8 

8 

©KEY 

1 

1 

©KEYIN 

9 

9 

©KLTSK 

32 

20 

©LOAD 

76 

4C 

©LOC 

63 

3F 

©LOF 

64 

40 

©LOGER 

11 

0B 

©LOGOT 

12 

0C 

©MSG 

13 

0D 

• 
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Label  Dec  Hex 

@MUL8 

@MUL16 

@OPEN 

@PARAM 

©PAUSE 

@PEOF 

@POSN 

©PRINT 

@PRT 

@PUT 

@RAMDIR 

@RDHDR 

@RDSEC 

@RDSSC 

@RDTRK 

©READ 

©REMOV 

©RENAM 

©REW 

©RMTSK 

©RPTSK 

©RREAD 

©RSLCT 

©RSTOR 

©RUN 

©RWRIT 

©SEEK 

©SEEKSC 

©SKIP 

©SLCT 

©SOUND 

©STEPI 

©TIME 

©VDCTL 

©VER 

©VRSEC 

©WEOF 

©WHERE 

©WRITE 

©WRSEC 

©WRSSC 

©WRTRK 


90 

5A 

91 

5B 

59 

3B 

17 

11 

16 

10 

65 

41 

66 

42 

14 

OE 

6 

6 

4 

4 

35 

23 

48 

30 

49 

31 

85 

55 

51 

33 

67 

43 

57 

39 

56 

38 

68 

44 

30 

1E 

31 

1F 

69 

45 

47 

2F 

44 

2C 

77 

4D 

70 

46 

46 

2E 

71 

47 

72 

48 

41 

29 

104 

68 

45 

2D 

19 

13 

15 

OF 

73 

49 

50 

32 

74 

4A 

7 

7 

75 

4B 

53 

35 

54 

36 

55 

37 
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Sample  Programs 


The  following  sample  programs  use  many  of 
the  supervisor  calls  described  in  this  man- 
ual. These  programs  are  not  meant  to  be 
examples  of  the  most  efficient  programming, 
but  are  designed  to  Illustrate  as  many  super- 
visor calls  as  possible. 


o 
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Sample  Program  A 


Ln  # 

00001 

00002 
00003 
00004 
00005 
00007 

00008 
00009 
00010 
00011 
00012 
00013 
00014 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
00022 
00023 

0002  4 
00025 
00026 
00027 
00028 
00029 
00030 
00031 
00032 

0003  3 
00034 
00035 
00036 
00037 
00038 
0003  9 
00040 
00041 
00042 

13 


00044 
00045 
00046 
00047 
00048 
00049 
00050 
00051 
00052 
0005  3 
0005  4 
00055 
00056 
00057 
00058 

0005  9 
00060 
00061 
00062 
00063 
00064 
00065 

0006  6 
00067 


©DEBUG: 
GDSPLY: 
@FSPECj 

@KEY: 

@LOAD: 

@RUN: 

MESS1: 


PROGRM: 
FCBl: 


RUNIT: 


Source  Line 

This  program  asks  the  user  whether  to  run  a  program 
or  debug  it  and  executes  the  SVCs  required  to  perform 
the  chosen  action. 

PSECT   5000H  ;The  program  begins  at  x'5000' 

Define  the  equates  for  the  SVCs  that  will  be  used. 

(DEBUG) 


EQU 
EQU 
EQU 

EQU 
EQU 
EQU 

DEFM 
DEFB 
DEFM 
DEFB 

DEFM 
DEFB 


27 
10 
78 

1 

76 

77 


;  Enter  the  debugger 

;Display  a  message 

;Verify  a  filespec  or  devspec  and 

rload  it  into  a  File  Control  Block 

;Get  a  character  from  the  keyboard 

;Load  a  program  into  memory 

; Execute  a  program 


'Do  you  wish  to  RUN  this  Program  or  DEBUG  it  ?' 

0AH  ;This  moves  the  cursor  to  the  next  line 

'Press  <ENTER>  to  RUN  or  <BREAK>  to  DEBUG' 

0DH  ;Terminate  the  message  string 

'DIREX/CMD'      ; Sample  program  to  debug  or  execute 
0DH  ;Terminate  the  filespec 


DEFS    32  ;File  Control  Block  for  the  program 

Get  the  File  Control  Block  for  the  program  'DIREX/CMD' . 


START :   LD 

LD 
LD 

RST 

LD 
LD 

RST 

LD 
RST 

CP 
JR 


HL,PROGRM  ; Point  at  the  filespec  we  want  to 
; execute  or  load  into  memory 

DE,FCB1  ;Point  at  the  File  Control  Block 

A,@FSPEC  ; perform  a  validity  check  on  the  filespec 
;and  copy  the  filespec  into  the  FCB. 

28H  ;Call  the  9FSPEC  svc 

HL,MESS1  ;Point  at  our  prompting  message 

A,@DSPLY  ;and  print  it  on  the  display 

28H  .-Call  the  @DSPLY  svc 

A,@KEY  ;Get  the  reply  from  the  keyboard 

28H  ;Call  the  @KEY  svc 

0DH  ;Was  the  character  an  <ENTER>? 

Z, RUNIT  ;lf  Z   was  set,  then  run  the  program 


If  it  wasn't  an  <ENTER> ,  then  we  assume  it  was  a  <BREAK>  and 
load  the  program  and  enter  the  debugger. 

;Point  at  the  File  Control  Block 

;and  have  this  program  loaded  into  memory 

;Call  the  gLOAD  svc 

Note  that  this  program  must  not  be  overwritten  by  the  program 
we  are  loading.   In  this  example,  it  is  known  that  the  program 
we  are  loading  starts  at  x'3000'  and  ends  below  x'5000'. 


LD 

DE,FCB1 

LD 

A, @ LOAD 

RST 

28H 

LD 
RST 


A,@DEBUG 
28H 


Execute  the  program 


LD 
LD 

RST 


DE,FCB1 

A,@RUN 

28H 


;Now  invoke  the  system  debugger,  DEBUG 

;Call  the  @DEBUG  svc 

;Note  that  GDEBUG  does  not  return 


;Point  at  the  File  Control  Block 
;Tell  TRSDOS  to  load  and  execute  the 
; program 
;Call  the  @RUN  svc 
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oampie  rrogram  m,  continued 

00068  ;Note  that  @RUN  returns  only  if  it  can't 

00069  ffind  the  program 
00070 

00071  ;       Note  that  the  program  that  is  loaded  by  the  @RUN  svc  must  not 

00072  ;        overwrite  the  File  Control  Block  in  this  program.   In  this  case, 

00073  ;        it  is  known  that  the  program  we  are  executing  starts  at  x'3000' 

00074  ;       and  ends  below  the  starting  point  of  this  program,  x'5000". 
00075 

00076  END      START 


# 


c 


w 
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Sample  Program  B 


00001 

00002 
00003 
00004 
00005 
00006 
00007 
00008 
00010 

00011 
00012 
00013 
00014 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
00022 
00023 
00024 
00025 
00026 
00027 
00028 
0002  9 
00030 
00031 
00032 
00033 
00034 
00035 
00036 
00037 
00038 
00039 


00041 
00042 
00043 
00044 
00045 
00046 
00047 
00048 

0004  9 
00050 
00051 
00052 

0005  3 
0005  4 
00055 
00056 
00057 
00058 

0005  9 
00060 
00061 

0006  2 
00063 
00064 
00065 
00066 
00067 
00068 


;This  program  accepts  numbers  from  the  keyboard 
;and  uses  them  to  demonstrate  the 
;arithmetic  and  numeric  conversion  SVCs. 

;It  also  uses  the  sound  function  to  produce  a  tone  at  the 
;beginning  of  the  program. 

PSECT    3000H 

;       These  are  the  SVCs  used  in  this  program. 


@DECHEX:EQU 

@DIV8:  EQU 

GDIV16:  EQU 

@DSP :  EQU 

8DSPLY:  EQU 

gEXIT:  EQU 

@HEX8:  EQU 

@HEX16:  EQU 
@HEXDEC:EQU 

@KEY:  EQU 

@KEYIN:  EQU 
GMUL8: 
SMUL16 
GSOUND 


EQU 
EQU 
EQU 


96 

93 

94 

2 

10 

22 

98 

99 

97 

1 

9 

90 

91 

104 


Convert  decimal  ASCII  to  binary 

Perform  8-bit  division 

Perforin  16-bit  division 

Display  a  character 

Display  a  message 

Return  to  TRSDOS  Ready  or  the  caller 

Convert  an  8-bit  value  to  hex  ASCII 

Convert  a  16-bit  value  to  hex  ASCII 

Convert  a  binary  value  to  Decimal  ASCII 

Read  a  character  from  *KI 

Accept  an  input  line  from  *KI 

Perform  8-bit  multiplication 

Perform  16-bit  multiplication 

Produce  a  tone 


Other  equates . 


NUM5 
NUM4 
NUM3 
NUM2 
NUMl 
BRK: 
CCC: 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


5 

4 

3 

2 

1 

80H 

0DH 


;Character  code  for  <BREAK>  key 
;Next  line  position 


;Perform  a  subroutine  2  times  to  display  prompting  messages,  key  in 
;and  display  divisor  and  dividend,  convert  those  numbers  to 
; binary  for  the  divide,  and  position  the  cursor. 


START: 


LD 
LD 
RST 

CALL 

LD 

LD 

LD 

CALL 

LD 

LD 

CALL 

CALL 

LD 

LD 


B,5AH 

A,@SOUND 

28H 

KEYIN 

A,C 

(DIVD1) ,A 

HL,MESS9 

DSPLAY 

A, (DIVD1) 

C,A 

HEX  8 

KEYIN 

A,C 

(DIVR1) ,A 


;Make  the  longest,  highest  tone 
;Make  the  noise 

;Perform  keyin  subroutine  for  dividend 

; Store  the  dividend  in  memory 

; Address  of  hex  message 

;Display  hex  message 

;Get  the  divisor  into  C  for  conversion 

;from  binary  to  hex 

;Convert  the  number  to  hex 

; Perform  subroutine  for  divisor 

; Store  the  divisor  in  memory 


;Now  we  are  ready  to  perform  the  divide  on  the  numbers  entered. 


LD 
LD 
LD 
LD 
RST 


C,A 

A, (DIVDl) 

E,A 

A,@DIV8 

28H 


;Put  the  divisor  back  for  the  @DIV8  SVC 
;Get  the  dividend  into  E 
;for  the  @DIV8  SVC 
;Call  the  @DIV8  SVC 


;Now  display  the  answer  and  the  remainder  in  decimal. 

LD      (ANSI), A        ;Store  the  answer  in  memory 
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Sample  Program  B,  continued 


LD 
LD 
LD 

CALL 

LD 

LD 

LD 

CALL 

LD 

CALL 

LD 

LD 

LD 

CALL 


A,E 

(REMl) ,A 

HL,MESS3 

DSPLAY 

A, (ANSI) 

L,A 

H,JI 

HEXDEC 

HL,MESS4 

DSPLAY 

A, (REMl) 

L,A 

H,0 

HEXDEC 


;Get  the  remainder 

; Store  the  remainder  in  memory 

rLoad  address  of  answer  message 

;Display  the  message 

;Get  the  answer  into  L  for  conversion 

; Number  to  convert 

;Put  a  0  in  the  MSB 

; Perform  subroutine  to  display  decimal  value 

;Address  of  remainder  message 

;Display  remainder  message 

;Put  remainder  in  A  for  hex  conversion 

;Number  to  convert 

;Put  0  in  the  MSB 

; Display  decimal  value 


• 


;Now  divide  with  a  16-bit  dividend. 


LD 

CALL 

LD 

LD 

LD 

LD 

RST 

LD 

RST 

LD 

LD 

CALL 

LD 

CALL 

CALL 

LD 

LD 

LD 

CALL 

LD 

LD 

LD 

LD 

RST 

LD 

LD 

CALL 

LD 

CALL 

LD 

LD 

LD 

CALL 


HL,MESS6 

DSPLAY 

A,@KEYIN 

HL,BUF6 

B,NUM5 

C,0 

28H 

A,@DECHEX 

28H 

(DIVD2) ,BC 

HL,MESS9 

DSPLAY 

DE, (DIVD2) 

HEX16 

KEY  IN 

A,C 

(DIVRl) ,A 

HL,MESS3 

DSPLAY 

HL, (DIVD2) 

A, (DIVRl) 

C,A 

A,§DIV16 

28H 

(REMl) ,A 

(ANS2) ,HL 

HEXDEC 

HL,MESS4 

DSPLAY 

A, (REMl) 

L,A 

H,0 

HEXDEC 


;Address  of  2nd  dividend  message 

;Display  next  message 

;Key  in  up  to  5  digits 

; Store  the  number 

; Maximum  length  of  number 


;Convert  the  number  to  binary 

;Store  the  dividend 

;Address  of  hex  message 

^Display  hex  message 

;Put  dividend  into  DE  for  conversion 

;Convert  the  number  from  binary  to  hex 

;Key  in  divisor 

;Put  the  divisor  into  A 

; Store  the  divisor  in  memory 

;Address  of  answer  message 

;Display  the  message 

;Put  dividend  into  HL 

;Get  divisor  into  C 


;Store  the  remainder 

;Put  the  answer  into  HL 

;Display  answer  in  decimal 

;Address  of  remainder  message 

^Display  remainder  message 

;Get  the  remainder 

;into  L 

;Put  a  0  in  MSB 

;Convert  the  remainder  to  decimal 


c 


;Now  try  some  multiplication  of  8  bits, 


LD 

CALL 

LD 

LD 

LD 

LD 

RST 

LD 

RST 

LD 

LD 

CALL 

LD 

LD 


HL,MESS8 

DSPLAY 

A,eKEYIN 

HL,BUF2 

B,NUM2 

C,0 

28H 

A.SDECHEX 

28H 

(MCANDl) ,BC 

HL, MESS 10 

DSPLAY 

A,@KEYIN 

HL,BUF2 


; Address  of  MUL8  message 

;Display  first  multiplicand  message 

;Key  in  a  2-digit  number 

; Put  it  here 

; Maximum  number  of  characters 


;Convert  the  number  to  binary  for  math 

; Store  the  multiplicand 

; Address  of  M0L8  multiplier  message 

jDisplay  first  multiplier  message 

;Key  in  the  multiplier 

;Put  it  here 


w 
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sample  program  b,  connnuea 


00136 

LD 

B,NUM1 

00137 

LD 

C,0 

00138 

RST 

28H 

00139 

LD 

A,gDECHEX 

00140 

RST 

28H 

00141 

LD 

(MIERl) ,BC 

00142 

LD 

HL, MESS 13 

00143 

LD 

A,@DSPLY 

00144 

RST 

28H 

00145 

00146 

;Now  multiply 

the  two  numbe 

00147 

00148 

LD 

A, (MCAND1) 

00149 

LD 

C,A 

00150 

LD 

A, (MIERl) 

00151 

LD 

E,A 

00152 

LD 

A,@MUL8 

00153 

RST 

28H 

00154 

LD 

L,A 

00155 

LD 

H,0 

00156 

CALL 

HEXDEC 

00157 

00158 

;Now  multiply 

a  16-bit  by  a 

00159 

00160 

LD 

HL, MESS 11 

00161 

CALL 

DSPLAY 

00162 

LD 

A,@KEYIN 

00163 

LD 

HL,BLFF5 

00164 

LD 

B , NUM4 

00165 

LD 

C,0 

00166 

RST 

28H 

00167 

LD 

A,@DECHEX 

00168 

RST 

28H 

0016  9 

LD 

(MCAND2) ,BC 

00170 

LD 

HL,MESS12 

00171 

CALL 

DSP LAY 

00172 

LD 

A,@KEYIN 

00173 

LD 

HL,BUF3 

00174 

LD 

B , NUM2 

00175 

LD 

C,0 

00176 

RST 

28H 

00177 

LD 

A,@DECHEX 

00178 

RST 

28H 

00179 

LD 

(MIERl) ,BC 

00180 

LD 

HL, MESS 13 

00181 

LD 

A,@DSPLY 

00182 

RST 

28H 

00183 

LD 

HL, (MCAND2) 

00184 

LD 

A, (MIERl) 

00185 

LD 

C,A 

00186 

LD 

A,@MUL16 

00187 

RST 

28H 

00188 

LD 

H,L 

00189 

00190 

LD 

L,A 

00191 

LD 

DE,BUF5 

00192 

LD 

A,§HEXDEC 

00193 

RST 

28H 

00194 

LD 

A,CCC 

00195 

LD 

(DE) ,A 

00196 

LD 

HL,BUF5 

00197 

LD 

A,@DSPLY 

00198 

RST 

28H 

00199 

LD 

HL,MESS14 

00200 

LD 

A,@DSPLY 

00201 

RST 

28H 

00202 

LD 

A,@KEY 

00203 

RST 

28H 

; Maximum  number  of  characters 


;Convert  the  multiplier  to  binary  for  math 

;Store  multiplier  in  memory 
;Address  of  multiplier  message 
;Display  multiplier  message 


;Get  the  multiplicand  into  C 
;Get  the  multiplier  into  E 


;Put  the  product  into  L 

;Put  0  in  the  MSB 

;Convert  the  product  to  decimal 


;Address  of  multiplicand  message 

;Display  2nd  multiplicand  message 

;Enter  larger  multiplicand 

;Put  it  here 

; Maximum  number  of  characters 


;Convert  the  number  to  binary  for  math 

;Store  the  multiplicand  in  memory 

;Address  of  multiplier  message 

;Display  message 

;Enter  larger  multiplier 

;Put  it  here 

; Maximum  number  of  characters 


;Convert  the  number  to  binary  for  math 

; Store  the  multiplier  in  memory 
;Address  of  product  message 
;Display  the  message 

;Put  multiplicand  into  HL 
;Get  the  multiplier  into  C 

; Multiply  the  two  numbers 

;Get  the  2nd  byte  of  the  product  into 
;H  for  conversion 

;Get  the  LSB  into  L  for  conversion 
;Convert  the  high-order  byte  to  decimal 
;for  the  display 

;Tell  the  display  when  to  stop 


; Display  the  product 

;Address  of  end  message 
;Display  end  message 

;Allow  the  user  to  enter  any  character 
;or  hit  <BREAK> 
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Sample  Program  B,  continued 


00204 
00205 
00206 
00207 
00208 
00209 
00210 
00211 
00212 
00213 
00214 
00215 
00216 
00217 
00218 
00219 
00220 
00221 
00222 
00223 
00224 
00225 
00226 
00227 
00228 
00229 
00230 
00231 
00232 
00233 
00234 
00235 
00236 
00237 
00238 
002  39 
002  40 
00241 
00242 
00243 
00244 
00245 
00246 
00247 
00248 
00249 
00250 
00251 
0025  2 

0025  3 
00254 
00255 
00256 
00257 
00258 
00259 
00260 
00261 
00262 
00263 
00264 

0026  5 
00266 
00267 
00268 
00269 
00270 
00271 


CP 

BRK 

JP 

NZ, START 

LD 

A,@EXIT 

RST 

28H 

;Is  it  <BREAK>? 

;Yes,  go  back  to  beginning 

;No,  exit  the  program 


;These  are  the  subroutines  used  by  the  calls  to 

;display  a  message,  key  in  a  3-digit  number,  and  convert  it 

;from  decimal  to  binary. 


KEYI8: 


LD 

CALL 

LD 

LD 

LD 

LD 

RST 

LD 

RST 

RET 


HL.MESSl 

DSPLAY 

HL,BUF4 

B,N0M3 

C0 

A,@KEYIN 

28H 

A,@DECHEX 

28H 


;Display  message 
;put  the  number  here 
jMaximum  number  of  characters 

;Key  in  a  number 

;Convert  the  number  to  binary 

;Return  to  next  sequential  instruction 


• 


; Display  what  was  loaded  into  HL  before  the  call. 


DSPLAY:  LD 
RST 
DEC 
LD 

DSPLYLP:LD 
LD 
RST 
DJNZ 
RET 


A,@DSPLY  ;@DISPLAY  SVC 
28H 

HL  ;Set  HL  back  to  blank  byte 

B, (HL)  ;Load  B  with  the  number  of  bytes 

C  '  ? Put  a  blank  into  C 

A,@DSP  fDisplay  the  blank 

28H  ; until  the  correct  number 

DSPLYLP  ;of  blanks  have  been  displayed 
; Return  to  next  instruction 


;Convert  1  byte  to  hexadecimal. 


HEX8: 


LD 

LD 

RST 

LD 

LD 

LD 

LD 

RST 

RET 


A,@HEX8 

HL,BUF3 

28H 

A,CCC 

(HL) ,A 

A,@DSPLY 

HL,BUF3 

28H 


;Convert  2  bytes  to  hexadecimal, 


HEX16: 


LD 

LD 

RST 

LD 

LD 

LD 

LD 

RST 

RET 


A,@HEX16 

HL,BUF6 

28H 

A,CCC 

(HL) ,A 

A,@DSPLY 

HL,BUF6 

28H 


;Convert  from  binary  to  decimal 


HEXDEC  s 


LD 

LD 

RST 

LD 

LD 

LD 

LD 

RST 

RET 


A,@HEXDEC 

DE,BUF5 

28H 

A,CCC 

(DE) ,A 

A,@DSPLY 

HL,BUF5 

28H 


;Convert  1  byte  to  hex  ASCII 
;Put  the  converted  value  here 

;Tell  display  when  to  stop 
;Put  CCC  at  end  of  buffer 
;Display  the  hex  value 


; Return  to  next  instruction 


;Convert  a  2-byte  number  to  hex  ASCII 
;Put  the  converted  value  here 

;CCC  at  end  of  buffer  so  display 
;knows  when  to  stop 
rDisplay  the  converted  value 
;Address  of  converted  value 

;Return  to  next  instruction 

and  display  decimal  value. 

;Convert  from  binary  to  decimal 
;Put  converted  value  here 

;CCC  at  end  of  buffer  so  display 
; knows  when  to  stop 
;Display  the  hex  value 
;It's  here 

; Return  to  next  instruction 


C 


w 
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Sample  Program  B,  continued 


00272 
00273 
00274 
00275 
00276 
00277 
00278 
00279 
00280 
00281 
00282 
00283 
0028  4 
00285 
00286 
00287 
00288 
00289 
002  90 
00291 
00292 
00293 
00294 
00295 
00296 
00297 
002  98 
00299 
00300 
00301 
00302 
00303 
00304 
00305 
00306 
00307 
00308 
00309 
00310 
00311 
00312 
00313 
00314 
00315 
00316 
00317 
00318 
00319 
00320 
00321 
00322 
00323 


;These  are  the  storage  declarations, 


BUF6: 

BUF5 

BUF4: 

B0F3: 

BUF2: 

DIVRl: 

DIVDl: 

ANSI: 

REM1: 

MCANDl: 

MIER1: 

MCAND2: 

DIVD2: 

ANS2: 


DEFS 
DEFS 
DEFS 
DEFS 
DEFS 
DEFB 
DEFB 
DEFB 
DEFB 
DEFB 
DEFB 
DEFW 
DEFW 
DEFW 


6 
5 
4 
3 
2 
0 
0 


0 
0 
0 
0 
0 


MESS 4: 

MESS6: 

MESS 8 : 

MESS9 : 

MESS 10: 

MESS 11: 

MESS12: 
MESS13: 
MESS14: 


DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFM 
DEFB 
DEFM 
DEFB 

END 


13 


;Number  of  blanks  to  print  after  message  1 


; Below  are  messages  and  prompting  text  used  in  the  program 

MESS1: 

MESS 3: 


'Enter  a  number  (1-255).' 


3 

21 

'The  answer  is' 

3 

18 


;Message-terminating  character 

;Number  of  blanks  to  print  after  message  3 


;Terminating  character 

;Blanks  after  message 
'The  remainder  is* 

3  terminating  character 

6  ;Blanks  after  message 

'Enter  a  number  (4369-65535).' 
3  terminating  character 

15  ; Blanks  after  message 
'Enter  a  number  (1-28).' 

3  terminating  character 

16  ; Blanks  after  message 
'In  hex  ASCII,  that  is' 

3  terminating  character 

17  ; Blanks  after  message 
'Enter  a  number  (1-9).' 

3  terminating  character 

11  ;Blanks  after  message 

'Enter  a  number  (1-4100).' 

3  terminating  character 

15  ;Blanks  after  message 

'Enter  a  number  (1-15).' 

3  terminating  character 

'The  product  of  those  2  numbers  is  ' 

3  terminating  character 

'Press  <BREAK>  to  end  or  any  other  key  to  continue.' 

0DH  ."Terminating  character 

START 
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Sample  Program  C 


Ln  # 

00001 
00002 
00003 
00004 
00005 
00006 
00006 
00009 
00010 
00011 
00012 
00013 
00014 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
0002  2 
00023 
00024 
00025 
00026 
00027 
00028 
00029 
00030 
00031 
00032 
00033 
00034 
00035 
00036 
00037 
00038 
00039 
00040 
00041 
00042 
00043 
00044 
00045 
00046 
00047 
00048 
00049 
00050 
00051 
0005  2 
00053 
00054 

0005  5 
00056 
00057 
00058 
00059 
00060 
00061 

0006  2 
00063 
0006  4 
0006  5 
0006  6 
00067 


Source1  Line  -^ 

This  program  prompts  for  two  filenames,  opens  the  first 
file,  and  creates  the  second.   Then  the  data  in  the  first 
file  is  copied  to  the  second  file.   While  the  Copy  progresses, 
the  current  record  number  is  displayed  in  parentheses. 


PSECT    3000H 


;This  program  starts  at  x'3000' 


First,  declare  the  equates  for  the  SVCs  we  intend  to  use. 

This  is  not  mandatory,  but  it  makes  the  program  easier  to  follow. 


• 


eCLOSE:  EQU 
@DIRRD :  EQU 
@DSP:  EQU 
8DSPLY:  EQU 
TERROR:  EQU 
GEXIT:  EQU 
@FEXT:  EQU 
€FNAME:  EQU 
@FSPEC :  EQU 
@HEXDEC:EQU 
eiNIT:  EQU 
@KBD:  EQU 
9KEYIN:  EQU 
@LOC:  EQU 
©OPEN:  EQU 
@READ :  EQU 
@REMOV:  EQU 
@VER :    EQU 


60 
87 
2 

10 

26 

22 

79 

80 

78 

97 

58 

8 

9 

63 

59 

67 

57 

73 


Close  a  file  or  device 

Read  a  directory  record 

Display  character  at  cursor 

Display  a  message 

Display  an  error  message 

Exit  and  return  to  TRSDOS  or  the  caller 

Add  a  default  file  extension 

Fetch  a  filespec  from  the  directory 

Verify  and  load  a  filespec  into  the  FCB 

Convert  a  binary  value  to  decimal  ASCII 

Open  an  existing  file  or  create  a  new  file 

Scan  the  keyboard  for  a  character 

Accept  a  line  of  text  from  the  *KI  device 

Return  the  current  logical  record  number 

Open  an  existing  file 

Read  a  record  from  an  open  file 

Delete  a  file  from  disk 

Write  a  record  to  disk.   Does  the  same  thing 

as  @WRITE  (Svc  75),  but  it  also  makes  sure 

the  written  data  is  readable. 


First,  prompt  for  the  source  filespec  using  the  @DSPLY  svc. 

BEGIN:   LD       HL,MESGl         ;Get  the  first  message 

jDisplay  a  line  on  the  screen 
;Call  the  GDSPLY  svc 

read  the  filename  from  the  keyboard  using  the  6KEYIN  svc. 

;Put  the  name  of  the  1st  file  here 

;Allow  up  to  24  characters 

;A  zero  is  required  by  the  svc 

;Get  a  filename  from  the  user 

;Call  the  GKEYIN  svc 

;The  user  pressed  <Break> 

;An  Error  occurred 

;Get  the  number  of  characters 
;See  if  that  value  was  zero 
;Nothing  was  entered,  ask  again 

The  user  has  typed  something,  so  it  must  be  checked  for  validity 
using  the  @FSPEC  svc. 


LD 

HL,MESG1 

LD 

A,gDSPLY 

RST 

28H 

Now, 

read  the  fi 

LD 

HL,FILE1 

LD 

B,24 

LD 

C,0 

LD 

A,@KEYIN 

RST 

28H 

JP 

CQUIT 

JP 

NZ,ERR 

LD 

A,B 

OR 

A 

JR 

Z, BEGIN 

o 


LD 

LD 

LD 


RST 
JR 


HL,FILE1 
DE,FCB1 

A,@FSPEC 


28H 
Z,ASK2 


fPoint  at  the  text  the  user  entered 

;Point  at  the  File  Control  Block 

;that  is  to  be  used  for  the  source  file. 

;The  @FSPEC  svc  will  make  sure  the  filename 

;that  is  in  buffer  named  "filel"  is  valid. 

;If  it  is,  it  is  copied  into  the  File 

;Control  Block  (FCB)  to  be  used  by  the  eoPEN 

;or  @INIT  svc  later  on. 

fCall  the  GFSPEC  svc 

;The  name  for  file  1  is  ok,  so  skip  this 


At  this  point  the  filename  specified  for  file  1  has  been  found 
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Sample  Program  C,  continued 


00068 
00069 
00070 
00071 
00072 
00073 
00074 
00075 
00076 
00077 
00078 
00079 
00080 
00081 
00082 
00083 
00084 
00085 
00086 
00087 
00088 
00089 


to  be  in  an  invalid  format, 
error  message. 


The  following  code  will  print  the 


00091 
00092 
00093 
00094 
00095 
00096 
00097 
00098 
00099 
00100 
00101 
00102 
00103 
00104 
00105 
00106 
00107 
00108 
00109 
00110 
00111 
00112 
00113 
00114 
00115 
00116 
00117 
00118 
00119 
00120 
00121 
00122 
00123 
00124 
00125 
00126 
00127 
00128 
00129 
00130 
00131 
00132 
00133 
00134 
00135 


ASK2: 


F20K: 


FDIV: 


EXTN: 


LD 

HL,BADFIL 

LD 

A,@DSPLY 

RST 

28H 

JR 

BEGrN 

;Point  at  the  bad  filename  message 

;Display  it 

;Call  the  @DSPLY  svc 

;Start  over 

At  this  point,  the  source  filename  appears  to  be  valid. 

The  code  below  asks  for  the  second  filename  and  checks  it  for 

validity  also. 

;Prompt  for  the  target  filename 

;Print  that  on  the  screen 

;Call  the  GDSPLY  svc 

;Put  the  name  of  the  2nd  file  here 

;Allow  up  to  24  characters 

;A  zero  is  required  by  the  svc 

;Get  a  filename  from  the  user 

;Call  the  @KEYIN  svc 

;The  user  pressed  <Break> 

;An  Error  occurred 

;Get  the  number  of  characters 
;See  if  that  value  was  zero. 
;Nothing  was  entered,  ask  again 

The  user  has  typed  something,  so  it  must  be  checked  for  validity 
using  the  @FSPEC  svc. 

;Point  at  the  text  the  user  entered 

; Point  at  the  File  Control  Block 

;Check  the  name  for  validity 

;Call  the  @FSPEC  svc 

;The  name  for  file  2  is  ok,  so  skip  this 


LD 

HL,MESG2 

LD 

A,@DSPLY 

RST 

28H 

LD 

HL,FILE2 

LD 

B,24 

LD 

C,0 

LD 

A,@KEYIN 

RST 

28H 

JP 

CQUIT 

JP 

NZ,ERR 

LD 

A,B 

OR 

A 

JR 

Z,ASK2 

LD 

HL,FILE2 

LD 

DE,FCB2 

LD 

A, 3FSPEC 

RST 

28H 

JR 

Z,F20K 

The 

name  for  file 

LD 

HL,BADFIL 

LD 

A,@DSPL¥ 

RST 

28H 

JR 

BEGIN 

; Point  at  the  bad  filename  message 

;Display  it 

;Call  the  GDSPLY  svc 

; Start  over 

Now  we  will  attempt  to  add  an  extension  to  the  target  file 

if  the  user  did  not  specify  one.   We  use  the  extension  that 

was  specified  on  the  source  file.   If  it  does 

not  have  one,  then  we  will  not  try  to  add  one  to  the  target  file. 

; Point  at  the  source  filename 

;We  start  with  the  second  character  since 

;the  filename  must  be  at  least  one  character 

;Get  a  character  from  the  filespec 

;Is  the  character  the  extension  prefix? 

;Yes,  this  will  be  our  default  extension 

;Have  we  reached  the  end  of  the  filespec? 

I  Yes,  there  is  no  extension  so  don't  add  one 

;Test  both  terminators 

;Advance  the  pointer  to  the  next  character 
;Keep  looking 

;Advance  pointer  to  first  byte  of  extension 
; Point  at  FCB  for  the  target  file  (file  2) 
;Add  an  extension  if  one  is  not  present 
;Call  the  @FEXT  svc 


LD 

HL,FCB1+1 

LD 

A, <HL) 

CP 

V 

JR 

Z , EXTN 

CP 

0DH 

JR 

Z , NOEXT 

CP 

03H 

JR 

Z , NOEXT 

INC 

HL 

JR 

FDIV 

INC 

HL 

LD 

DE,FCB2 

LD 

A,@FEXT 

RST 

28H 

Now  we  have  two  filenames, 
to  make  sure  it  exists. 


First  we  will  open  the  source  file 
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00136 

00137 
00138 

0013  9 
00140 
00141 
00142 
00143 

0014  4 
00145 
00146 
001 47 
00148 
00149 
00150 
00151 
00152 
00153 
00154 
00155 
00156 
00157 
00158 
00159 
00160 
00161 
00162 
00163 

0016  4 
00165 
00166 
00167 
00168 
00169 
00170 
00171 
00172 

0017  3 
00174 
00175 
00176 
00177 
00178 
00179 
00180 
00181 
00182 
00183 
00184 
00185 
00186 
00187 
00188 
00189 
00190 
00191 
00192 
00193 
00194 
00195 
00196 
00197 
00198 
00199 
00200 
00201 
00202 
00203 


NOEXT : 


LD 
LD 


SIZ: 


EXISTS; 


WAIT; 


LD 


DE,FCBl 
HL,BUF1 


B,0 


LD 

A,@OPEN 

RST 

28H 

JR 

Z,S1Z 

CP 

42 

JP 

NZ,ERR 

;Point  at  the  File  Control  Block  for  filel 

;Point  at  the  system  buffer.   This  buffer 

;is  used  by  the  system  to  block  data  that 

;is  written  to  disk  and  de-block  data  that 

;is  read  from  disk  when  the  Logical  Record 

;Length  of  the  file  is  not  256.   If  it  is 

;256,  then  this  buffer  is  not  used. 

fUse  LRL  256  for  now  since  we  don't  know 

;what  to  use  yet. 

;Open  the  file 

;Call  the  @OPEN  svc 

;The  file  opened  and  is  LRL  256. 

;Was  the  error  a  LRL  Open  Fault? 

;No,  perhaps  the  file  does  not  exist. 

At  this  point,  the  file  is  open  and  we  can  now  examine  the 
directory  to  find  out  what  LRL  it  was  created  with  so  we  can 
use  that  value  to  make  the  copy. 

;Get  the  byte  in  the  FCB  which  contains 

;the  drive  number  the  file  is  on 

;Erase  all  other  information  in  that  byte 

;Save  that  value  here 

;This  reads  the  Directory  Entry  Code  (DEC) 

;out  of  the  FCB  so  we  can  use  it 

; Store  the  DEC  here 

;Save  that  value  for  now 

;We  can  close  the  source  file  for  now 

;Call  the  GCLOSE  svc 

;Get  the  DEC  value  back  off  the  stack 
;Read  the  directory  record  for  that  file 
;Call  the  @DIRRD  svc 

;Put  the  pointer  to  the  directory  record 
fhere  and  read  the  DIR+4  entry  which 
;contains  the  LRL  of  the  source  file. 
;Save  that  value 

Before  we  go  any  further,  we  should  check  to  see  if  the  target  file 
already  exists. 

; First,  make  a  copy  of  the  FCB 
;in  case  we  have  to  delete  a  file 
;Move  the  entire  block 


;Point  at  the  target  File  Control  Block 

;Use  this  as  the  buffer  for  now 

;Use  LRL  256  for  now 

;Open  it  and  see  if  it  is  there 

;Call  the  @OPEN  svc 

;The  file  already  exists,  better  ask 

;Was  the  error  a  LRL  mismatch? 

;No,  so  the  file  does  not  exist. 

; Point  at  a  prompt  asking  if  it  is  ok 
;to  erase  the  file  that  already  exists 
; Print  that  message 
;Call  the  §DSPL¥  svc 

;Wait  for  the  user  to  type  Y  or  N 

;Call  the  ©KBD  svc 

;Loop  until  something  is  typed 

;Was  a  'Y'  typed? 
;Then  kill  the  file 


LD 

A,  (FCBl+6) 

AND 

LD 

LD 

7 

C,A 

A, (FCBl+7) 

LD 

PUSH 
LD 
RST 

B,A 

BC 

A,@CLOSE 

28H 

POP 

LD 

RST 

BC 

A,@DIRRD 

28H 

LD 
LD 

IX, HL 
A, <IX+4) 

LD 

(LRL) ,A 

c 


LD 

DE,COPY 

LD 

HL,FCB2 

LD 

BC,32 

LDIR 

LD 

DE,FCB2 

LD 

HL,BUF2 

LD 

B,0 

LD 

A,@OPEN 

RST 

28H 

JR 

Z, EXISTS 

CP 

42 

JR 

NZ,NOFILE 

LD 

HL,FEXST 

LD 

A,@DSPLY 

RST 

28H 

LD 

A,@KBD 

RST 

2BH 

JR 

NZ,WAIT 

CP 

,y, 

JR 

Z,KILLIT 
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00204 

00205 

00206 

00207 

00208 

00209 

00210 

00211 

00212 

00213 

00214 

00215 

00216 

00217 

00218 

00219 

00220 

00221 

00222 

00223 

00224 

00225 

00226 

00227 

00228 

00229 

00230 

00231 

002  32 

00233 

00234 

00235 

00236 

00237 

00238 

00239 

002  40 

00241 

00242 

00243 

00244 

00245 

00246 

002  47 

002  48 

002  49 

00250 

00251 

00252 

00253 

0025  4 

00255 

00256 

00257 

00258 

0025  9 

00260 

00261 

00262 

00263 

00264 

00265 

00266 

00267 

00268 

00269 

00270 


SHUT: 


;Check  for  lowercase  too 

;Do  they  want  to  leave  the  file  alone? 

;No,  just  close  the  file  and  quit 

;Was  it  a  lowercase  'N'? 

;No,  loop  until  we  see  something  we  like 

;Close  the  target  file 

;Call  the  ©CLOSE  svc 
;Exit  to  TRSDOS 

At  this  point,  we  have  been  given  the  OK  to  delete  the  file 
that  has  the  same  name  as  the  target  file. 


CP 

■y' 

JR 

Z,KILLIT 

CP 

'N' 

JR 

2, SHUT 

CP 

*n' 

JR 

NZ.WAIT 

LD 

DE,FCB2 

LD 

A,@CLOSE 

RST 

28H 

JP 

QUIT 

KILLIT:  LD 
LD 
RST 

LD 
LD 
RST 

JP 


C0DH 

A,@DSP 

28H 

DE,FCB2 

A,@REMOV 

28H 

NZ,ERR 


;First  move  display  to  a  new  line 
;Display  an  <Enter> 
jCall  the  @DSP  svc 

; Point  at  the  target  file's  FCB 

;Delete  the  file  from  disk 

jCall  the  3REM0V  svc.   (This  is  the  same 

;as  the  @KILL  call  on  other  TRSDOS  systems.) 

;An  error  occurred,  print  it  and  quit 

;Note  that  after  a  @REMOV  succeeds, 

;the  filespec  is  removed  from  the  FCB. 

j So  we  have  to  keep  a  copy  around 

;in  case  we  need  it. 

;Get  the  copy 

;Put  it  here 

;Move  up  to  32  bytes 

;Copy  the  FCB  so  we  can  continue 

Now  we  know  what  Logical  Record  Length  (LRL)  to  use  in  the 
copy,  so  we  can  open  the  source  file  and  create  the  target  file 
with  the  correct  record  lengths. 


LD 

HL,COPY 

LD 

DE,FCB2 

LD 

BC,32 

LDIR 

NOFILE:  LD 
LD 
RST 
LD 
LD 
RST 

LD 

LD 

LD 

LD 

LD 

RST 

JP 


LD 
LD 
RST 

LD 
LD 
CP 
JR 
LD 
JR 
LD 


LRL256 : 


LRLCOM: 


LD 
LD 


HL,FCB1 

A,@DSPLY 

28H 

HL, SPACES 

A,@DSPLY 

28H 

DE,FCB1 

HL,BUF1 

A, (LRL) 

B,A 

A,30PEN 

28H 

NZ,ERR 

HL, ARROW 
A,3DSPLY 
28H 

DE,FCB2 

A, (LRL) 

0 

Z,LRL256 

HL,BUF2 

LRLCOM 

HL.BUFl 


B,A 

ArSlNIT 


; Point  at  the  filename  in  the  FCB 

; Print  that  name 

;Call  the  GDSPLY  svc 

; Point  at  some  spaces 

;Space  over  a  few  places  on  the  screen 

;Call  the  @DSPLY  svc 

;Point  at  File  Control  Block  for  source  file 

;Put  data  in  this 

;Read  the  Logical  Record  Length 

;Load  the  Logical  Record  Length 

;Open  the  source  file 

;Call  the  ©OPEN  svc 

fOpen  failed 

;Point  at  the  arrow  text 

;Print  that  to  show  the  direction  of  copy 

;Call  the  GDSPLY  svc 

; Point  at  File  Control  Block  for  target  file 

;Get  the  Logical  Record  Length 

;ls  the  LRL  256? 

;Then  we  do  something  special 

;Use  a  different  buffer  for  target  file 

;Jump  to  common  code 

;We  use  the  same  buffer  when  the  LRL  is  256 

;since  there  is  no  need  to  block  and  de-block 

;the  data. 

;Load  the  Logical  Record  Length 

;Open  the  target  file 
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00271 

00272 

00273 

00274 

00275 

00276 

00277 

00278 

00279 

00280 

00281 

00282 

00283 

00284 

00285 

00286 

00287 

00288 

00289 

00290 

00291 

00292 

00293 

00294 

00295 

00296 

00297 

00298 

00299 

00300 

00301 

00302 

00303 

00304 

00305 

00306 

00307 

00308 

00309 

00310 

00311 

00312 

00313 

00314 

00315 

00316 

00317 

00318 

00319 

00320 

00321 

00322 

00323 

00324 

00325 

00326 

00327 

00328 

00329 

00330 

00331 

00332 

00333 

00334 

00335 

00336 

00337 

00338 


RST 

28H 

JR 

HZ, ERR 

LD 

DE,F1LE2 

LOOP: 


EDIT: 


NUMBR : 


;Call  the  @INIT  svc 
.;Init  failed 

;We  are  going  to  get  the  filename  for 

;the  target  file  from  the  system 

; instead  of  using  the  one  we  have.   The 

jreason  for  this  is  that  the  system  will 

;append  the  drive  number  to  the  filename 

;if  one  was  not  specified. 

;Get  the  Directory  Entry  Code  for  the  file 

;Put  the  DEC  here 

;Get  the  Drive  Number  from  the  FCB 

;Lose  all  data  except  the  drive  number 

;Store  drive  number  here 

;Have  the  system  produce  a  filespec 

,-Call  the  §FNAME  svc 

;Now  point  at  the  filespec  produced 

;and  print  it  out 

;Call  the  @DSPLY  svc 

; Space  over  a  few  more  places 
;so  the  display  will  look  neat 
;Call  the  8DSPLY  svc 

At  this  point,  both  files  are  open  and  ready  to  be  used. 
The  following  code  reads  a  record  from  the  source  file 
and  writes  it  to  the  target  file.   This  is  done  until  an 
end  of  file  is  encountered. 

;Point  at  file  1  (source  file) 

;Put  data  here 

;Read  a  record  from  the  source  file 

;Call  the  @READ  svc 

;Jump  if  the  eof  has  been  reached 

;Point  at  file  2  (target  file) 

Before  writing  the  record,  display  the  record  number,  which 
is  obtained  from  the  @LOC  svc. 


LD 

A,  (FCB2+7) 

LD 

B,A 

LD 

A,  (FCB2+6) 

AND 

7 

LD 

C,A 

LD 

A, 8FNAME 

RST 

28H 

LD 

HL,FILE2 

LD 

A,@DSPLY 

RST 

28H 

LD 

HL, SPACES 

LD 

A,@DSPLY 

RST 

28H 

• 


LD 

DE,FCB1 

LD 

HL, BUFFER 

LD 

A, 8 RE AD 

RST 

28H 

JR 

NZ,EOF 

LD 

DE,FCB2 

LD 

RST 

POSH 
POP 

LD 
LD 

RST 

LD 

LD 

CP 

JR 

INC 

JR 

DEC 

LD 
LD 


LD 

LD 
RST 


A,§LOC 
28H 

BC 

HL 

DE,L0CMSG+1 

A,@HEXDEC 

28H 

A,'  ' 

HL,LOCHSG 
(HL) 

NZ,NUMBR 
HL 

EDIT 

HL 
A,  M  ' 

(HL) ,A 


HL,LOCMSG 

A,§DSPLY 

28H 


;Get  the  current  record  number 
fCall  the  §LOC  svc 

;Get  the  current  record  number 

;and  put  it  in  register  HL 

; Store  the  result  here. 

jConvert  binary  to  ASCII  in  decimal  format 

fCall  the  SHEXDEC  svc 

;Get  a  blank 

;Look  at  the  front  of  the  buffer 

;Is  the  character  a  blank? 

;A  number  has  been  found 

; Advance  the  pointer 

;Loop  until  we  find  a  number 

;Back  up  one  position 

;Get  the  character  we  want  to  insert 

;Store  that  character. 

;The  buffer  now  contains 

;<none  or  more  spacesX record  number) 

;<7  left-cursor  characters><etx> 

; Point  at  this  text 

;and  display  it  on  the  screen 

;Call  the  @DSPLY  svc 


o 


Now  write  the  record  to  the  target  file. 

LD      DE,FCB2         ;Point  at  the  FCB  for  the  target  file 


V 
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i 


00339 

LD 

HL, BUFFER 

;Point  at  the  data  read  from  file  1 

00340 

LD 

A,@VER 

;Write  a  record  to  the  target  file 

00341 

;The  @VER  does  the  same  thing  as  the 

00342 

;@WRITE  svc,  only  it  also  checks  the 

00343 

;data  to  make  sure  it  is  readable. 

00344 

RST 

28H 

.-Call  the  3VER  svc 

00345 

JR 

NZ,ERR 

;An  error  occurred  on  write;  possibly 

00346 

;the  disk  is  full. 

00347 

JR 

LOOP 

;Loop  until  an  error  occurs. 

00348 

00349 

t 

This  code  checks  the 

error  to  make  sure  it  was  an  end  of  file 

00350 

1 

condition  and,  if  so, 

.  closes  the  source  &  target  files. 

00351 

00352 

EOF: 

CP 

28 

;Was  it  an  end  of  file  encountered? 

00353 

JR 

Z, EOF YES 

;Yes,  close  the  file 

00354 

CP 

29 

;Was  it  "Record  number  out  of  range"? 

00355 

JR 

NZ,ERR 

;No,  must  be  some  other  error 

00356 

00357 

J 

It  is  possible  to  get  Error  29  if  the  file  being  copied  has 

00358 

t 

an  EOF 

that  is  not  a 

multiple  of  the  file's  LRL 

00359 

00360 

EOF YES : 

LD 

DE,FCB1 

;Point  at  file  1  (source  file) 

00361 

LD 

A,@CLOSE 

;Close  the  file 

00362 

RST 

28H 

;Call  the  @CLOSE  svc 

00363 

JR 

NZ,ERR 

;An  error  occurred,,  abort 

00364 

' 

00365 

LD 

DE,FCB2 

;Point  at  file  2  (target  file) 

00366 

LD 

A,@CLOSE 

;Close  it  also 

00367 

RST 

28H 

;Call  the  3 CLOSE  svc 

00368 

JR 

NZ , ERR 

;An  error  occurred,  abort 

00369 

00370 

LD 

HL,OK 

;Print  a  message  saying  the  copy  is  done 

00371 

LD 

A,§DSPLY 

00372 

RST 

28H 

,-Call  the  GDSPLY  svc 

00373 

00374 

QUIT: 

LD 

A,SEXIT 

;Exit  to  TRSDOS  or  the  calling  program 

00375 

RST 

28H 

;Call  the  SEXIT  svc 

00376 

00377 

r 

The  @EXIT  svc  does  not  return. 

00378 

00379 

ERR; 

OR 

040H 

;Turn  on  bit  6,  which 

00380 

fwill  cause  the  TERROR  svc  to  print 

00381 

;the  short  error  message.  Bit  7 

00382 

;is  not  set,  which  instructs  the  TERROR 

00383 

;to  abort  this  program  and  return  to 

00384 

; TRSDOS  Ready. 

00385 

LD 

C,A 

;Put  error  code  &  flags  in  register  C 

00386 

LD 

A,  @ ERROR 

;Call  the  system  error  displayer 

00387 

RST 

28M 

;Call  the  TERROR  svc 

00388 

00389 

7 

Because 

bit  7  is  not 

set,  the  TERROR  svc  will  not  return. 

00390 

00391 

t 

Storage 

Declaration 

00392 

00393 

SPACES: 

DEFM 

i    r 

; ASCII  Space  char. for  display  formatting 

00394 

DEFB 

3 

00395 

ARROW: 

DEFM 

■=>   ' 

;Arrow  for  display  shows  data  direction 

00396 

DEFB 

3 

00397 

OK: 

DEFB 

10%25 

; Advance  cursor  10  spaces  without  erasing 

00398 

DEFM 

■10k]' 

;Used  to  indicate  the  Copy  is  complete 

00399 

DEFB 

0DH 

; Terminated  with  an  <Enter> 

00400 

MESG1 : 

DEFM 

'Copy  Filespec  >' 

00401 

DEFB 

3 

00402 

MESG2: 

DEFM 

'To  Filespec 

>• 

00403 

DEFB 

3 

00404 

FEXST: 

DEFM 

'Destination 

File  Already  Exists  -  Ok  to  Delete  it  (Y/N)  ?• 

00405 

DEFB 

3 
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00406 
00407 
00408 
00409 
00410 
00411 
00412 
00413 
00414 
00415 
00416 
00417 
00418 
00419 
00420 
00421 
00422 
00423 
00424 


BADFIL: 
LOCMSG : 


FILE1: 

FILE2: 

FCB1: 

FCB2: 

COPY: 

LRLi 

B0F1: 
BUF2: 
BUFFER; 


DEFM 
DEFB 
DEFM 

DEFB 
DEFB 

DEFS 
DEFS 
DEFS 
DEFS 
DEFS 
DEFB 

DEFS 
DEFS 
DEFS 

END 


'Invalid  Filename 
0DH 


Try  Again' 


'  12345) ' 

7%24 
3 

32 
32 
32 
32 
32 
0 

256 
256 
256 

BEGIN 


;This  will  be  used  in  building  the  LOC 
;Display  will  appear  as  (d)  to  (ddddd). 
jBackspace  without  erasing 
;Etx,  used  to  get  the  @DSPLY  svc  to  stop 

;Oser  Text  Originally  placed  here 

; Target  Filename  goes  here 

j 32  bytes  for  the  File  Control  Block 

;32  bytes  for  the  File  Control  Block 

;An  extra  copy  of  the  target  FCB  goes  here 

fThe  Logical  Record  Length  of  the  source 

;file  will  be  stored  here 

;System  buffer  for  File  1 

; System  buffer  for  File  2 

;Data  buffer  for  both  files 

; "begin"  is  the  starting  address 


G 


v 
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Ln  # 


Source  Line 


00001 
00002 
00003 
00004 
00005 
00006 
00007 
00009 
00010 
00011 
00012 
00013 
00014 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
00022 
00023 
00024 
00025 
00026 
0002  7 
00028 

0002  9 
00030 
00031 
00032 
00033 

0003  4 
00035 
0003  6 
00037 
00038 
0003  9 
00040 
00041 
00042 
00043 
00044 
00045 
00046 
00047 
00048 
00049 
00050 
00051 
00052 
0005  3 
00054 
0005  5 
00056 
00057 
00058 

0005  9 
00060 
00061 
00062 

0006  3 
00064 
00065 
00066 
00067 


This  program  will  read  a  sector  from  the  disk  in  Drive  0 
and  will  write  it  to  a  disk  in  Drive  1.   The  disk  in  Drive  1 
must  be  formatted,  but  should  not  have  anything  important  on 
it.   This  program  makes  an  assumption  that  the  directory  is 
located  on  cylinder  20  (x'141). 


PSECT    3000H 


;This  program  begins  at  x'3000' 


Define  the  equates  for  the  SVCs  that  will  be  used. 


e ABORT:  EQO 

GCKDRV:  EQU 
GDCSTAT : EQO 

@ ERROR:  EQU 

@EXIT:  EQU 

§RDSEC:  EQU 

@RDSSC:  EQU 

@WRSEC:  EQU 

@WRSSC:  EQU 


21 
33 
40 
26 
22 
49 
85 
53 
54 


Other  Equates 


SYS SEC :  EQU 
USRSEC:  EQU 


1400H 
0000  H 


; Abort  and  return  to  TRSDOS 

;Test  to  see  if  a  drive  is  ready 

;Verify  that  a  drive  is  defined  in  the  DCT 

;Display  an  error  message 

;Return  to  TRSDOS  or  the  calling  program 

;Read  a  sector 

;Read  a  system  sector 

;Write  a  sector 

;Write  a  system  sector 


;The  system  sector  is  Cylinder  20,  Sector  0 
;The  regular  sector  is  Cylinder  0,  Sector  0 


;       First,  test  the  target  drive  and  make  sure  it  is  defined. 

START:   LD      C,l  ; Select  Drive  1 

LD      A,@DCSTAT       ; Ask  if  the  drive  is  listed  in  the  DCT 
RST      28H  ;Call  the  6DCSTAT  svc 

JR      NZ, ERROR         ;If  NZ,  then  the  drive  is  not  defined 

;and  we  will  abort  execution. 

;       Now,  test  and  make  sure  the  target  drive  contains  a  formatted 
;       disk  and  is  write-enabled. 


LD      C,l 

LD       A,@CKDRV 


Select  Drive  1 

Test  to  see  if  the  disk  is  formatted 

and  is  write-enabled.   Note  that  the 

disk  must  be  formatted  by  TRSDOS  6.x 

or  by  LDOS  5.1.x  to  be  considered 

"formatted"  by  this  svc. 

Call  the  GCKDRV  svc 

This  will  become  the  error  number  if  the 

drive  was  not  ready.   This  is  done 

because  the  8CKDRV  svc  does  not  return  error 

codes . 

The  drive  is  not  ready 

This  will  become  the  error  number  if  the 

drive  is  ready  and  is  write-protected . 

As  above,  this  is  done  because  6CKDRV  does 

not  return  error  messages. 

The  disk  is  formatted,  but  it  is 

write-protected.   In  either  case,  abort. 

Now  that  we  know  the  target  drive  is  ready,  read  a  sector 

from  the  source  drive  and  write  it  to  the  target  drive  (Drive  1) . 

;Select  Drive  0 

;Read  the  first  sector  on  the  disk, 

;Cylinder  0,  Sector  0. 

;Point  to  a  buffer  which  will  hold  the  sector 

;Read  a  non- system  sector 

;Call  the  @RDSEC  svc 

;If  NZ,  an  error  occurred,  so  abort 


RST 

28H 

LD 

A,  8 

JR 

NZ, ERROR 

LD 

A, 15 

JR 

C, ERROR 

LD 

C,0 

LD 

DE, USRSEC 

LD 

HL,BUFF 

LD 

A,@RDSEC 

RST 

28H 

JR 

NZ, ERROR 
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Sample  Program  D,  continued 


00068 

00069 

00070 

00071 

00072 

00073 

00074 

00075 

00076 

00077 

00078 

00079 

00080 

00081 

00082 

00083 

00084 

00085 

00086 

00087 

00088 

00089 

00090 

00091 

00092 

00093 

00094 

00095 

00096 

00097 

00098 

00099 

00100 

00101 

00102 

00103 

00104 

00105 

00106 

00107 

00108 

00109 

00110 

00111 

00112 

00113 

00114 

00115 

00116 

00117 

00118 

00119 

00120 

00121 

00122 

00123 

00124 

00125 

00126 

00127 


ERROR : 


LD 

C,0 

LD 

DE,SYSSEG 

LD 

HL,BUFF 

LD 

A,@RDSSC 

RST 

28H 

JR 

NZ, ERROR 

BUFF: 


Now,  write  the  sector  to  the  target  drive. 

LD  C,l  ; Select  Drive  1 

LD  DE,USRSEC  ;Write  the  sector  to  Cylinder  0,  Sector  0 

;on  Drive  1 

LD  HL,BUFF  ;Point  to  the  buffer  containing  the  sector 

LD  A,@WRSEC  ; Write  the  sector  to  disk 

RST  28H  ;Call  the  SWRSEC  svc 

JR  NZ, ERROR  ;If  NZ,  an  error  occurred,  so  abort 

Now  we  will  read  a  system  sector  from  Drive  0  and  write  it  on 
drive  1.   The  difference  between  a  system  sector  and  a  non-system 
sector  is  that  the  Data  Address  Marks  (DAM)  are  different.   These 
were  written  to  the  disk  when  it  was  formatted.   TRSDOS  6.x  uses 
these  as  an  extra  check  to  make  sure  that  a  write  of  user  data 
does  not  accidentally  get  placed  over  a  sector  containing  system 
data.   All  of  the  sectors  in  the  directory  cylinder  are  marked 
as  system  sectors . 

;Select  Drive  0 

;Read  Cylinder  20,  Sector  0 

; Store  the  sector  at  this  address 

;Read  a  system  sector 

;Call  the  @RDSSC  svc 

j An  error  occurred,  so  abort 

Now  write  the  sector  to  the  target  drive  as  a  system  sector . 
There  is  no  requirement  that  a  sector  must  be  placed  at  the 
same  cylinder  and  sector  location  as  it  was  read  from,  but 
for  simplicity,  we  are  doing  that. 

;Select  Drive  1 

j Write  Cylinder  20,  Sector  0 

; Point  to  the  data  to  be  written 

;Write  a  system  sector 

;Call  the  GWRSSC  svc 

;An  error  occurred,  so  abort 

; Return  to  TRSDOS  or  the  calling  program 
;Call  the  @EXIT  svc 

This  routine  displays  an  error  message  if  anything  goes  wrong. 
Note  that  9CKDRV  does  not  return  an  error  message,  so  TERROR 
cannot  be  used  for  it  without  some  manipulation. 

;Set  bit  7 

;Load  error  number  into  register  C 
fThis  will  display  the  error  message 
;and  return  to  the  calling  program 
j Call  the  e ERROR  svc 

;Now,  force  an  abort.  This  will  return 
;to  TRSDOS  Ready  and  will  abort  any 
;JCL  file  that  is  currently  executing 
;Call  the  3ABORT  svc 

;256-byte  buffer  to  store  the  sector  that 
;is  read  and  then  written 


• 


LD 

C,l 

LD 

DE.SYSSEC 

LD 

HL,BOFF 

LD 

A,§WRSSC 

RST 

28H 

JR. 

NZ, ERROR 

LD 

A, § EXIT 

RST 

28H 

c 


OR 
LD 
LD 

0C0H 

C,A 

A, § ERROR 

RST 

28H 

LD 

A, e ABORT 

RST 

28H 

DEFS 

256 

END 


START 


<W 
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Sample  Program  E 


Ln  # 


Source  Line 


00001 
00002 
00002 
00004 
00006 
00001 
00008 
00009 
00010 
00011 
00012 
00013 
00014 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
00022 
00023 
00024 
00025 
00026 
00027 
00028 

0002  9 
00030 
00031 
00032 
00033 

0003  4 
00035 
00036 

0003  7 
00038 
00039 
00040 
00041 
00042 
00043 

0004  4 
00045 
00046 
00047 


00049 
00050 
00051 
00052 
0005  3 
0005  4 
00055 
00056 
00057 
00058 
00059 
00060 
00061 
00062 
00063 
00064 
00065 
00066 
00067 


START  t 


DIR0: 


This  program  displays  the  filenames  of  the  disk  in 
Drive  0  three  different  ways. 


PSECT    3000H 


;Program  begins  at  x'3000' 


First,  declare  the  equates  for  the  SVCs  we  intend  to  use. 

This  is  not  mandatory,  but  it  makes  the  program  easier  to  follow. 


@CMNDI:  EQU 
@CMNDR:  EQU 
@DODIR:  EQU 


24 
25 
34 


; Execute  a  TRSDOS  command  and  return 

;to  TRSDOS  Ready 

; Execute  a  TRSDOS  command  and  return 

;to  the  calling  program 

;Display  visible  filenames  on  the 

;specified  disk  drive 


LD 

HL,DIR0 

LD 

A,@CMNDR 

RST 

28H 

First,  pass  a  "DIR  :0"  command  to  the  system.   TRSDOS  will 
execute  this  command  and  then  return  to  this  program. 

; Point  at  command  we  want  to  execute 

; Execute  the  specified  command  and  return 

;Call  the  GCMNDR  svc 

You  may  have  noticed  that  the  DIR  displayed  the  files,  but  that 
they  were  not  sorted  alphabetically.   This  is  because  the  DIR 
command  will  not  use  memory  above  x'3000'  when  it  is  invoked  with 
a  QCMNDR  svc.   This  prevents  the  DIR  command  from  performing  a 
sort  of  the  filenames. 


Now  do  a  directory  command  using  the  @DODIR  svc. 


LD 

LD 
LD 


RST 


B,0 

C,0 
A,@DODIR 


28H 


;Use  Function  0  which  displays  all 
;visible  files  in  the  directory. 
;Put  source  drive  number  in  register 
;The  filenames  will  be  read  from  the 
;directory  and  displayed  in  the 
;order  they  appear  in  the  directory. 
;Call  the  iDODIR  svc 


Now  pass  a  "DIR  :0"  command  to  the  system.   This  time 

the  command  will  be  executed  and  then  TRSDOS  will  not  return 

to  this  program,  but  will  return  to  TRSDOS  Ready. 


LD 
LD 

RST 


HL,DIR0 
A,@CMNDI 

28H 


;Point  at  the  command  we  want  performed 

;and  execute  it,  but  don't  return  to 

;this  program. 

;Call  the  SCMNDI  svc 

;This  svc  returns  to  TRSDOS  Ready. 


Note  that  when  the  library  command  DIR  is  performed  this  time, 
the  display  of  files  is  sorted.   This  is  because  DIR  determines 
that  it  was  invoked  with  a  @CMNDI  svc,  and  it  will  not  return 
to  the  calling  program.   Therefore,  DIR  is  free  to  use  the 
memory  above  x'3000'  to  perform  the  sort  of  the  filenames  in 
the  directory. 


Constants 
DEFM     'DIR  :0' 
DEFB     0DH 
END      START 


;This  command  is  passed  to  TRSDOS 

;via  the  9CMNDR  and  3CMNDI  SVCs. 

;It  must  be  terminated  with  an  <ENTER>. 
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Sample  Program  F 


Ln  # 


Source  Line 


00001 
00002 
00003 
00004 
00005 
00006 
00001 
00008 
00  009 
00010 
00011 
00012 
00013 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
00022 
00023 
00024 
00025 
00026 
00027 
00028 
00029 
00030 
00031 
00032 
00033 
00034 
00035 
00036 
00037 
00038 
00039 
00040 
00041 
00042 
00043 
00044 
00045 
00046 
00047 
00048 
00049 
00050 
00051 
00052 
0005  3 
0005  4 
00055 
00056 
00057 
00058 
0005  9 
00060 
00061 
00062 
00063 
00064 
00065 
00066 
00067 


CALLR : 


This  program  adds  to  the  system  task  scheduler  a  task 

which  displays  the  date  and  a  running  count  of  the  number 

of  times  the  task  has  been  executed. 

For  simplicity,  the  program  tries  to  use  task  slot  0. 

If  it  is  already  in  use,  it  assumes  that  the  task  using  that 

slot  is  this  program,  and  it  kills  the  task.  It  then  tries  to 

recover  the  memory  used  by  the  task  in  high  memory. 

If  the  task  slot  is  not  in  use,  the  task  is  placed  in  high  memory, 

and  the  address  of  the  task  is  passed  to  the  task  scheduler. 

The  first  time  you  run  this  program  it  adds  the  task,  and  the 

next  time  you  run  this  program,  it  removes  the  task. 


@ADTSK: 

GCKTSK: 

@DATE: 

@DSPL¥ : 

@EXIT: 

6GTMOD : 

8HEXDEC : 

eHIGH$ : 

GRMTSK: 

9VDCTL: 

SWHERE: 


• 


PSECT    3000H 


;This  program  starts  at  x'3000' 


First,  declare  the  equates  for  the  SVCs  we  intend  to  use. 

This  is  not  mandatory,  but  it  makes  the  program  easier  to  follow. 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


29 

28 

18 

10 

22 

83 

97 

100 

30 

15 

7 


;Add  a  task  entry  to  the  scheduler 

;Check  to  see  if  a  task  slot  is  in  use 

;Return  the  date  in  ASCII  format 

fDisplay  a  message 

; Return  to  TRSDOS  Ready  or  the  caller 

; Locate  a  memory  module 

;Convert  a  binary  value  to  decimal  ASCII 

;Read  or  modify  HIGH$  or  LOW$ 

;Remove  a  task  entry  from  the  scheduler 

;Perform  video  operations 

;Find  out  where  the  program  counter  is 

;when  this  SVC  is  executed.   This  is 

; useful  in  relocatable  code  that  must 

jmake  absolute  address  references  to 

;call  subroutines  or  modify  data. 


Below  we 
instructi 
where  it 
The  Z80  i 
not  have 
using  the 
in  a  regi 
the  stack 
to  reach 


will  define  a  macro 
on.   Since  the  task 
is  placed,  it  must 
nstruction  set  has 
a  call  relative  ins 

©WHERE  SVC,  Which 
ster.   This  address 

as  a  return  addres 
the  subroutine. 


to  simulate  a  call  relative 
must  be  able  to  run  no  matter 
use  relative  jumps  and  calls, 
a  jump  relative  ( JR) ,  but  does 
truction.   This  can  be  simulated 
returns  the  address  of  the  caller 

can  be  adjusted  and  placed  on 
s.  Then  a  jump  relative  can  be  used 


C 


MACRO  #1 

PUSH  HL 

PUSH  BC 

PUSH  AF 

LD  A,@WHERE 

RST  28H 

LD  BC, 3+1+1+1+1+2 


ADD  HL,8C 

POP  AF 

POP  BC 

EX  (SP),HL 

JR  #1 

ENDM 


#1  will  be  the  address  you  want  to  call 

Save  the  registers  we  damage 

Save  it 

Save  it 

Get  our  current  address 

Call  the  GWHERE  svc 

Get  the  lengths  of  the  instructions  after 

the  SVC.   This  will  allow  the  subroutine 

to  return  to  the  correct  address. 

Add  that  offset  to  where  we  are 

Put  stack  back 

Restore  registers 

Put  return  address  on  stack  and  restore  HL 

Jump  to  the  subroutine 

End  of  the  macro 


This  is  the  main  program.   It  loads  at  x'3000'.   It  decides 
if  it  needs  to  add  or  remove  the  task  in  the  scheduler  tables. 
If  it  adds  the  task,  it  moves  a  copy  to  the  top  of  memory  and 
protects  it,  and  adds  a  task  entry  to  the  scheduler. 
If  it  is  removing  a  task,  it  kills  the  entry  in  the  scheduler 
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Sample  Program  F,  continued 


00068 
00069 
00070 
00071 
00072 
00073 
00074 
00075 
00076 
00077 
00078 
00079 
00080 
00081 
00082 
00083 
00084 
00085 
00086 
00087 
00088 
00089 
00090 
00091 
00092 
00093 
00094 
00095 
00096 
00097 
00098 
00099 
00100 

00101 
00102 
00103 
00104 
00105 
00106 
00107 
00108 
00109 

00110 
00111 
00112 
00113 
00114 
00115 
00116 
00117 
00118 
00119 
00120 
00121 
0012  2 
00123 

0012  4 
00125 
00126 
00127 
00128 
00129 
00130 
00131 
00132 
00133 

0013  4 
00135 


tables ,  and  then  attempts  to  recover  the  memory  used  by  the  task , 

BEGIN:   LD       C,0  ;First,  we  will  test  slot  0 

;to  see  if  anyone  is  using  it 

;Call  the  GCKTSK  svc 

?There  is  a  task  using  slot  0,   kill  it 

At  this  point,  we  want  to  add  a  task  to  high  memory. 
Pirst  we  find  the  value  for  HIGH$  and  put  a  copy  of  the 
task  there.   Then  we  protect  the  task  by  moving  HIGH$  below 
the  new  task. 


LD 

C,0 

LD 

A,@CKTSK 

RST 

28H 

JR 

NZ,KILLIT 

LD 

LD 

LD 

RST 

LD 


LD 
LD 
LD 

LDDR 

LD 
LD 
LD 
RST 


HL,0 
B  H 

a!@high$ 

28H 
(ENDADD) ,HL 


;First,  get  the  value  of  HIGHS 
;Read  HIGHS 

;Call  the  THIGHS  svc 
;Save  this  value  as  the  last  address 
jthat  the  task  will  be  stored  in  once  it 
;is  moved  to  high  memory 


DE,HL  ;Put  that  value  here 

HL,M0DEND-1      ; Point  at  the  end  of  the  module 
BC,MODEND-MODULE;Move  the  module  from  where  it  is 

;right  now  to  a  position  below  HIGH$ 

;Do  the  copy 


HL,DE 
B,0 

A,@HIGH$ 
28H 


;Now  protect  the  module  using  HIGHS 
; Update  HIGH$ 

;Call  the  @HIGH$  svc 


Sow  we  need  to  load  the  TCB  entry  in  the  module  with  the  address 
of  the  first  instruction  to  be  executed. 

LD      IX, HL  ;IX  now  points  at  memory  header 

LD      BC,ENTRY-M0DULE+1      ;Get  the  offset  into  the  module 

;of  the  first  instruction 
ADD      HL,BC  ;HL  now  contains  the  actual  starting  address 

LD      (IX+(1+M0DTCB-M0DULE) ) ,L      ;Store  LSB  of  the  address 
LD      (IX+l+(l+MODTCB-M0DULE>)  ,H    ,-store  MSB  of  the  address 


Now  the  task  is  ready  to  run , 
scheduler  table. 


We  now  add  the  entry  to  the  task 


LD 


BC , M0DTCB-M0DULE+1 


PUSH 

IX 

POP 

HL 

ADD 

HL,BC 

LD 

DE,HL 

LD 

C,0 

LD 

A,@ADTSK 

RST 

28  H 

;Get  offset  into  the 

;module  of  the  TCB  word 
;Get  a  copy  of  the  base  address 
;Put  base  address  here 
;Now  HL  points  at  TCB  address 
rPut  that  value  in  DE 
;Add  this  entry  to  task  slot  0 
;Add  this  task,  to  be  run  every  266.67  msec 
jCall  the  6ADTSK  svc 


The  main  program  has  now  done  its  work  and  can  exit. 


LD  HL, ADDED 
LD  A,@DSPLY 
RST      28H 


LD 
RST 


A,@EXIT 
28H 


; Point  at  a  message  saying  what  was  done 

;and  print  it 

;Call  the  @DSPLY  SVC 

I  Now  exit 

;Call  the  @EXIT  svc 


This  SVC  does  not  return. 


This  part  of  the  code  removes  the  task  from  the  scheduler 
tables  and  then  attempts  to  recover  the  memory  that  was  used 
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Sample  Program  F,  continued 


by  the  task  in  high  memory.   If  another  high  memory  module 
was  added  AFTER  this  task  was  added,  then  the  memory  that 
was  used  by  this  task  cannot  be  recovered- 


KILLIT:  LD 
LD 

RST 


A,@RMTSK 
28H 


;We  want  to  remove  the  task  in  slot 
;Call  the  @RMTSK  svc 


At  this  point,  the  task  is  no  longer  called  by  the  operating 
system.   Now  we  want  to  determine  if  we  can 
reclaim  the  memory  it  was  using. 

Point  at  the  name  of  the  module 

Look  for  a  module  with  that  name 

Call  the  GGTMOD  svc 

If  NZ  is  set,  then  we  killed  some  other 

task  that  was  using  slot  0.   Oops. 

In  that  case,  just  stop  and  don't  do  any 

more  damage . 

Set  IX  to  point  to  the  module. 

Read  the  current  value  of  HIGH$ 

to  see  if  this  is  the  first  program  in 

high  memory 

If  it  is,  then  we  can  recover  the  space 

Call  the  §HIGH$  svc 

Move  HIGH$  up  by  one  byte 

Take  the  address  of  our  module 

and  store  it  here 

Compare  these 

Are  they  the  same? 

No,  the  high  memory  module  can't  be  removed 

At  this  point,  we  know  it  is  ok  to  reclaim  the  memory  used  by  the 
high  memory  task . 

;Read  the  end  of  module  value  out  of  the 

;header  information 

; Update  the  HIGH$  value 

;Call  the  @HIGH$  svc 

;Point  to  a  message  saying  all  is  well 

;and  print  it 

;Call  the  SDSPLY  svc 

;Exit  the  main  program 
;Call  the  3EXIT  svc 


• 


LD 

DE.MODNAM 

LD 

A,$GTMOD 

RST 

28H 

JR 

NZ,CANT 

LD 

IX, HL 

LD 

B,0 

LD 

HL,0 

LD 

A,@HIGH$ 

RST 

28H 

INC 

HL 

PUSH 

IX 

POP 

DE 

XOR 

A 

SBC 

HL,DE 

JR 

NZ,CANT 

LD 

HL, (IX+2) 

LD 
LD 
RST 

B,0 

A,@HIGH$ 

28H 

LD 
LD 

RST 

HL,OK 

A,@DSPLY 
28H 

LD 
RST 

A, e EXIT 
28H 

/""N 
W 


CANT; 


Here  we  will  display  a  message  saying  we  removed  the  task  from 
the  scheduler  table,  but  we  cannot  reclaim  the  memory  that  was 

used. 


LD 
LD 
RST 

LD 
RST 


HL,RECLM 
A,§DSPLY 
28H 

A, € EXIT 
28H 


; Point  to  the  message 
;and  display  it 
;Call  the  @DSPLY  svc 

;Now  exit 

;Call  the  GEXIT  svc 


;       Messages 

ADDED:   DEFM  'Task  placed  in  high  memory  and  scheduled.' 

DEFB  0DH 

OK:     DEFM  'Task  removed  from  scheduler  table  and  memory  reclaimed.' 

DEFB  0DH 

RECLM:   DEFM  'Task  removed  from  scheduler  table,  but  memory  could  not  ' 


« 
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Sample  Program  F,  continued 


00204 

00205 

00206 

00207 

00208 

00209 

00210 

00211 

00212 

00213 

00214 

00215 

00216 

00217 

00218 

00219 

00220 

00221 

00222 

00223 

00224 

00225 

00226 

00227 

00228 

00229 

00230 

00231 

00232 

00233 

00234 

00235 

00236 

002  37 

00238 

00239 

00240 

00241 

00242 

00243 

00244 

002  45 

00246 

00247 

00248 

00249 

00250 

00251 

00252 

00253 

0025  4 

00255 

00256 

00257 

00258 

0025  9 

00260 

00261 

00262 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 


DEFM    'be  recovered. 

DEFB     0DH 

The  Task  begins  at  this  point.   This  part  of  the  program  loads 
in  low  memory  but  is  relocated  to  a  point  just  below  HIGH$ . 

This  is  the  Memory  Header  Block.   This  block  of  data  allows 
the  system  to  locate  this  module  in  memory  by  name, 
using  the  @GTMOD  svc . 


MODULE:  JR 
ENDADD:  DEPW 


DEFB 
MODNAM:  DEFM 

MODTCB:  DEFW 


DEFW 


ENTRY 
0 


MODTCB-MODNAM 
'UPTIME* 


;Jump  (relative)  to  the  starting  address 

;The  highest  address  in  the  program. 

;This  value  is  patched  in  before  the  program 

;is  relocated.   This  will  be  used 

; later  in  recovering  the  memory  used  by 

;this  task. 

; Number  of  bytes  in  the  name  field  below. 

;This  is  the  name  of  the  module  and  is 

:used  to  identify  the  module. 

; Actual  address  to  start  execution.   This 

; value  is  patched  in  after  the  program  is 

;  relocated. 

;Spare  system  pointer  -  RESERVED 


This  area  contains  data  used  by  the  task.   It  is  addressed  using 
the  IX  register  which  points  to  the  task  when  it  is  executed. 


COUNTER: DEFW 
DATBUF:  DEFS 


0 
9 


;Count  of  how  many  times  we  have  run 
;The  date  is  stored  here 


This  is  the  actual  task. 

On  entry  to  the  task,  IX  points  at  the  Task  Control  Block  (TCB) , 
which  in  this  program  is  the  label  'MODTCB'.   All  data  is 
referenced  by  indexing  from  that  address. 


ENTRY t 


PUSH 


XY 


;Save  this  register.   It  is  not  saved  by 

;the  Task  Scheduler,  and  we  use  it. 

; Registers  AF,  BC,  DE,  and  HL  are  saved 


Now  we  will  read  the  current  date. 

;Get  a  copy  of  the  index  pointer 
BC,DATBUF-MODTCB;Get  the  offset  needed  to  access  the  date 
;Now  we  have  a  pointer  to  the  date 

jSave  the  pointer  to  the  start  of  the  task 
;Save  a  copy  of  that  pointer 
;Ask  the  system  what  the  date  is 
jCall  the  ©DATE  svc 

{Terminate  the  date  string 

;Put  pointer  to  the  date  here 

jWe  will  use  this  pointer  later  on 

;Put  the  cursor  on  the  top  line, 

;specified  in  register  HL 

;at  the  41st  position  on  the  screen 

;Write  the  message  at  the  position 

;Save  the  registers  we  damage 

;Save  it 

;Save  it 

;Get  our  current  address 

;Call  the  6 WHERE  svc 

;Get  the  lengths  of  the  instructions  after 
;the  SVC.   This  will  allow  the  subroutine 
;to  return  to  the  correct  address. 


LD 

HL,IX 

LD 

BC , DATBUF-MODT 

ADD 

HL,BC 

PUSH 

IX 

PUSH 

HL 

LD 

A,@DATE 

RST 

28H 

LD 

(HL)  ,0 

POP 

DE 

PUSH 

DE 

LD 

HL,0028H 

CALLR 

WRITE 

PUSH 

HL 

PUSH 

BC 

PUSH 

AF 

LD 

A,9WHERE 

RST 

28H 

LD 

BC, 3+1+1+1+1+2 
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Sample  Program  F,  continued 


ADD 

HL,BC 

POP 

AF 

POP 

BC 

EX 

(SP),HL 

JR 

WRITE 

;Add  that  offset  to  where  we  are 

;Put  stack  back 

;Restore  registers 

;Put  return  address  on  stack  and  restore  HL 

;Jump  to  the  subroutine 

;Note  that  the  above  was  actually  a  macro 

;which  perforins  a  relative  call. 

This  part  of  the  task  displays  a  count  of  the  number  of  times 
the  task  has  been  executed . 

;Get  the  pointer  to  DATBUP  back 
;Get  the  pointer  to  the  beginning  of 
;this  task 

;Save  the  pointer  to  DATBUF  again 
!B      ;Get  the  offset  to  our  data 

;area 
;Put  a  copy  of  the  base  address  in  HL 
;Add  offset.   Now  HL  points  to  COUNTER: 
;Put  the  pointer  to  COUNTER  in  IY 
;Get  LSB  of  the  counter 
;Get  MSB  of  the  counter 

; Increment  the  number  of  times  we  have  run 
; Store  the  LSB  of  the  counter 
; Store  the  MSB  of  the  counter 

Convert  the  count  to  decimal 
Call  the  0HEXDEC  svc 

Get  a  zero 

Terminate  the  count  string 

Put  pointer  to  date  here 

Put  the  cursor  on  the  top  line, 

specified  in  register  HL 

at  the  55th  position  on  the  screen 

Write  the  message  at  the  position 

Save  the  registers  we  damage 

Save  it 

Save  it 

Get  our  current  address 

Call  the  ewHERE  svc 

Get  the  lengths  of  the  instructions  after 

the  SVC.   This  will  allow  the  subroutine 

to  return  to  the  correct  address. 

Add  that  offset  to  where  we  are 

Put  stack  back 

Restore  registers 

Put  return  address  on  stack  and  restore  HL 

Jump  to  the  subroutine 

Note  that  the  above  was  actually  a  macro 

which  performs  a  relative  call. 

Now  we  restore  the  IY  register  and  return  to  the  task  scheduler. 


POP 

DE 

POP 

IX 

PUSH 

DE 

LD 

BC, COUNTER -MOD 

LD 

HL,IX 

ADD 

HL,BC 

LD 

IY,HL 

LD 

L, (IY) 

LD 

H, (IY+1) 

INC 

HL 

LD 

(IY) ,L 

LD 

(IY+1) ,H 

LD 

A,eHEXDEC 

RST 

28H 

XOR 

A 

LD 

(DE),A 

POP 

DE 

LD 

HL,0036H 

CALLR 

WRITE 

PUSH 

HL 

PUSH 

BC 

PUSH 

AF 

LD 

A,eWHERE 

RST 

28H 

LD 

BC, 3+1+1+1+1+2 

ADD 

HL,BC 

POP 

AF 

POP 

BC 

EX 

(SP) ,HL 

JR 

WRITE 

POP 
RET 


IY 


; Restore  IY  value 

; Return  to  the  task  scheduler 


This  routine  places  characters  on  the  display  using  the  @VDCTL 
svc  instead  of  @DSP  or  @DSPLY.   This  allows  the  cursor  to 
remain  at  its  current  position  when  we  write  to  the  screen. 
This  routine  must  be  called  using  the  relocatable  call  macro 
CALLR . 


WRITE: 


TSKLP : 


LD 
LD 


B,2 
A,  (DE) 


;Put  character  on  the  display 
;Get  a  character  to  display 


« 
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Sample  Program  F,  continued 


i 


00313 

OR 

A 

00314 

00315 

RET 

Z 

00316 

PUSH 

HI- 

00317 

PUSH 

DE 

00318 

PUSH 

BC 

00319 

LD 

C,A 

00320 

LD 

A,@VDCTX 

00321 

RST 

28H 

00322 

POP 

BC 

0032  3 

POP 

DE 

00324 

POP 

HL 

00325 

INC 

L 

00326 

INC 

DE 

00327 

JR 

TSKLP 

00328 

0032  9 

MODEND:  END 

BEGIN 

;Is  it  time  to  stop  putting  this  on 

;the  display? 

;Yes,  return  to  the  caller 

;Save  the  registers,  as  the  SVC  will 

;alter  the  contents 

;Put  the  character  here 

;Put  character  on  screen  at  specified  position 

;Call  the  @VDCTL  svc 

;Restore  registers 


rAdvance  display  position 

; Point  to  next  character  to  display 

;Loop  till  date  is  completely  displayed 

;End  of  task  and  main  program 


+#r 
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Sample  Program  G 


This  program  is  a  sample  Extended  Command  Interpreter.   You 

may  make  the  EC I  as  large  or  small  as  you  require.   You  may 

use  allof  main  memory,  or  you  can  restrict  yourself  to  the 

system  overlay  area  (x'2600'  to  x'2FFF'). 

To  pass  a  command  to  the  normal  system  interpreter  for 

processing,  use  the  @CMNDI  svc.   TRSDOS  executes  the  command 

and  reloads  the  ECI.   If  you  want  to  have  multiple  entry 

points,  Bits  2  -  0  in  EFLAG$  are  in  Register  A  on  entry 

(in  Bits  6  -  4), or  you  may  read  EFLAG$  yourself. 

EFLAG$  is  totally  dedicated  to  the  ECI,  and  may  contain  any 

non-zero  value.   If  EFLAG$  contains  a  zero,  TRSDOS  uses  its 

own  interpreter.   Other  programs  that  want  to  activate  an  ECI, 

should  set  the  EFLAG$  to  a  non-zero  value  and  execute  a  @EXIT 

svc. 


To  install  an  ECI,  use  the  command: 

COPY  filename  SYS13/SYS.LSIDOS:d  (C=N) 
If  you  omit  the  C=N  option,  the  SYS13  file  loses  it's  "SYS" 
status  and  you  will  receive  'Error  07'  messages  when  you  try 
to  use  it  as  a  ECI. 


When  SYS1  (the  normal  command  interpreter)  has  completed  it's 

normal  housekeeping  and  is  about  to  display  the  "TRSDOS  Ready" 

prompt,  it  checks  EFLAG$ .   If  EFLAG$  contains  a  non-zero 

value ,  TRSDOS  loads  and  executes  the  Extended  Command 

Interpreter. 

To  execute  this  program,  type  <*><Enter>. 

This  program  checks  EFLAG$  to  see  if  it  is  zero.   If  so,  it 
sets  it  to  a  non-zero  value.   This  causes  this  program  to  be 
used  instead  of  the  normal  interpreter  when  you  execute  an 
©EXIT  or  @ABORT  SVC.   (iCMNDI  and  @CMNDR  invoke  the  TRSDOS 
interpreter.)   If  EFLAG$  is  non-zero,  the  ECI  displays  a  few 
prompts  and  the  names  of  all  visible  /CMD  files  on  logical 
Drive  0. 
The  operator  may  then  type  the  name  of  a  program  to  execute. 

If  you  press  <Break>,   this  program  sets  EFLAG$  to  0,  executes 
an  lEXIT  SVC  and  returns  to  TRSDOS  Ready. 

By  pressing  a  number,  0  through  7,  you  can  specify  the  drive 
that  TRSDOS  searches.   This  program  stores  this  value  in 
EFLAG$.   Each  time  this  program  is  invoked,  it  reads  the  value 
from  EFLAG$  and  uses  that  drive. 


c 


Note  that  if  a  drive  is  not  enabled,  not  formatted,  doesn't 
exist,  or  contains  no  visible  /CMD  files,  this  program 
redisplays  the  prompt. 

PRINT    SHORT , NOMAC 


PSECT    3000H 


;This  program  starts  at  x'3000' 


Declare  the  equates  for  the  SVCs  used. 


;  This  is  not  mandatory, 

;  follow. 

§EXIT:  EQCJ  22 

GDSPLY:  EQU  10 

@ FLAGS:  EQU  101 

@DODIR:  EQU  34 

§KEYIN:  EQU  9 

6CMNDI:  EQU  24 


but  it  makes  the  program  easier  to 

;Exit  and  return  to  TRSDOS 

;Display  a  string 

;Locate  the  system  flag  area 

;Get  the  names  of  filenames 

jAccept  a  command  and  allow  editing 

;Execute  a  command  (using  SYS1) 


On  entry,  determine  if  EFLAG$  is  set  to  zero  or  not.   If  it 
is  set  to  zero,  this  program  is  being  started  by  typing 
PROGRAM<Enter>  or  <*><Enter>.   In  that  case,  set  EFLAG$  to  a 
non-zero  value  so  that  in  future,  TRSDOS  uses  this  interpreter 
instead  of  it's  own. 


w 
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00069 

00070 

00071 

00072 

area 

00073 

00074 

00075 

00076 

00077 

00078 

00079 

00080 

00081 

00082 

00083 

00064 

00085 

00086 

00087 

00088 

00089 

00090 

00091 

00092 

00093 

00094 

00095 

00096 

00097 

00098 

0009  9 

00100 

00101 

00102 

00103 

00104 

00105 

00106 

00107 

00108 

00109 

00110 

00111 

00112 

00113 

00114 

00115 

00116 

00117 

00118 

00119 

00120 

00121 

00122 

00123 

00124 

00125 

00126 

00127 

00128 

00129 

00130 

00131 

00132 

00133 

00134 

00135 

00136 


BEGIN: 


EC IRON  J 
ECIGO: 


ASK: 


Sample  Program  G,  continued 

If  EFLAGS  is  non-zero,  this  initialization  has  already  been 
done  and  can  be  skipped. 


LD 

RST 

LD 
OR 
JR 

LD 


LD 
LD 
JR 


A, @ FLAGS 

28H 

A,  (IY+4) 

A 

NZ,ECIRON 

A,  8 


(IY+4), A 
HL, PROMPT 
ECIGO 


;Get  the  starting  address  of  the  flag 

;Call  the  GFLAGS  svc 

;Read  the  EFLAG$  (Ed  flag) 
;Is  it  set  to  zero? 
;Run  the  EC I 

;Get  a  non-zero  value.   The  value 
;needs  to  be  a  non-zero  value  that 
;does  not  set  Bits  0,  1  or  2.   The 
;default  drive  #  is  kept  in  these  bits, 
;Set  the  EFLAG$  to  a  non-zero  value 
;Explain  how  this  works 
; Display  message 


When  the  system  is  about  to  display 

TRSDOS  Ready,  it  executes  this  code  instead. 

LD      HL,SPROMPT     ;Point  at  the  prompt  to  use 
LD      A, §DSPLY        ; Display  the  prompt 
RST      28H  ;Call  the  9DSPLY  svc 

Display  the  names  of  all  /CMD  files 

LD  A, (IY+4)  ;Get  the  EFLAGS 

AND  7  ;Delete  all  but  the  drive  number  field 

LD  C,A  ;Store  the  drive  number  for  the  svc 

LD  A,@DODIR  ;Do  a  directory  display 

LD  B,2  ;Display  visible,  non-system  files 

LD  HL,CMDTXT  ;that  match  "CMD"  (stored  at  CMDTXT) 

RST  28H  ;Call  the  GDODIR  svc 

Prompt  for  a  filename  or  a  function  key. 


LD 
LD 
LD 
LD 
RST 

JR 


HL, BUFFER 

B,9 

C,0 

A,@KEYIN 

28H 

CQUIT 


jPoint  at  text  buffer 

;Allow  up  to  8  characters  and  <Enter> 

; Required  by  the  svc 

;Input  text  with  edit  capability 

fCall  the  0KEYIN  svc 

;The  carry  flag  is  set  when  the 
joperator  presses  <BREAK>.  Zero  the 
;EFLAG$  and  exit  to  TRSDOS 

;Point  at  the  start  of  the  buffer 
;Get  the  character 

;Did  they  type  anything? 
;No,  just  repeat  the  prompt. 
;If  you  want  to  redisplay  the 
jdirectory,  change  "ASK"  to  "ECIRUN". 

;Convert  value  to  binary 
;Is  the  character  a  0  -  7? 
;Must  be  a  filename 

The  operator  has  typed  1  or  more  characters  that  start  with 

a  number.   This  program  assumes  that  the  operator  is  defining 

a  new  drive  number  and  stores  this  value  in  EFLAG$  for 

future  use.   TRSDOS  does  not  alter  this  value. 

The  next  time  this  program  is  run,  EFLAG$  contains  the 

same  value  and  this  program  knows  what  drive  to  scan. 


LD 

HL, BUFFER 

LD 

A, (HL) 

CP 

0DH 

JR 

Z,ASK 

SUB 

■0' 

CP 

7+1 

JR 

NC , NAME 

LD 
LD 


B,A 

A,  (IY+4) 


;Save  the  drive  number 
;Get  the  EFLAG$ 
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Sample  Program  G,  continued 


00137 
00138 
00139 
00140 
00141 

0014  2 
00143 
00144 
00145 
00146 
00147 
00148 
00149 
00150 
00151 
00152 
00153 
00154 

0015  5 
00156 
00157 
00158 
00159 
00160 
00161 
00162 
00163 
00164 
EFLAG$ , 
00165 
00166 
00167 
00168 
00169 
00170 
00171 
0017  2 
00173 
00174 
0017  5 
00176 
00177 
00178 
00179 
00179 
00180 
00181 
00182 
00183 
00184 
00185 
00186 
00187 
00188 
00189 
00190 
00191 

00192 
00193 

00194 
00195 
00196 
00197 

00198 
00199 
00200 


QUIT: 


NAME: 
FDIV: 


FOUND: 


;Delete  the  old  drive  number 
; Insert  the  new  drive  number 
;Save  that  value  for  future  use 
;Scan  the  new  drive 

<Break> .   Turn  off  the  ECI  and  return  to 

jGet  a  zero 

;Set  EFLAG$  to  zero 

; Point  at  the  shutdown  message 

?And  acknowledge  the  <Break> 

;Call  the  §DSPLY  svc 

; Return  to  TRSDOS  Ready 

;Call  the  @EXIT  svc 

The  operator  entered  what  might  be  a  filename  or  a  library 
command.   Pass  it  to  TRSDOS  for  processing.   If  there  is  an 
error,  TRSDOS  is  responsible  for  determining  what  the  error  is 
and  printing  a  message. 
<HL  already  points  at  the  start  of  the  buffer.) 


AMD 

8 

OR 

B 

LD 

<IY+4) ,A 

JR 

ECIRUN 

The 

ope 

rator  press 

TRSDOS . 

XOR 

A 

LD 

<IY+4),A 

LD 

HL,E PROMPT 

LD 

A,@DSPLY 

RST 

28H 

LD 

A,§EXIT 

RST 

28H 

LD 

CP 

JR 

INC 

JR 


A,0DH 

(HL) 

Z, FOUND 

HL 

FDIV 


;Look  for  this  character 

;In  the  command 

;Found  the  end  of  the  filename 

;Move  character  to  next  byte 

;Find  the  divider  (in  this  case,  a  0DH> 


Found  the  end  of  a  filename,  and  add  the  drive  number  from 

Note  that  this  program  may  not  work  properly  if  the  operator 
supplies  a  drive  number  as  part  of  the  filename. 

;Add  a  drive  number  to  the  filename 

; Advance  the  pointer  to  the  next  byte 

;Get  the  EFLAG$  value 

; Delete  all  but  the  drive  number 

;Convert  the  binary  value  to  ASCII 

;Add  that  to  the  filename 

; Advance  the  pointer  to  the  next  byte 

;Write  a  terminator  on  the  end 

;Point  at  the  text  entered 

; Execute  the  command,  but  do  not 

;return.  Since  this  program  is  the 

command  processor  at  this  time, TRSDOS 

;returns  control  to  the  beginning  of 

;this  module  after  executing  the 

; command. 

fCall  the  @CMNDI  svc 


LD 

(HL), ' : " 

INC 

HL 

LD 

A,  CIY+4) 

AND 

7 

ADD 

A,'0' 

LD 

( HL )  ,  A 

INC 

HL 

LD 

(HL) ,0DH 

LD 

HL, BUFFER 

LD 

A,eCMNDI 

o 


RST 


28H 


Messages  and  text  storage 


PROMPT:  DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFM 

DEFB 
DEFM 

DEFB 

SPROMPT : DEFB 
DEFM 

DEFM 
DEFB 


'[Extended  Command  Interpreter  Is  Now  Operational]' 

0AH 

0AH 

■Press  <BREAK>  to  use  the  normal  interpreter, 

0AH 

•type  <NumberXENTBR>  to  change  the  default  drive 

number, * 

0AH 

'or  type  the  name  of  the  program  to  run  and  press 

<ENTER>' 

0DH  ;Terminate  the  display 

0AH 

'IECI  On]  <BREAK>  to  abort,  n<ENTER>  for  new  drive  or 

type: ' 

*  program<ENTER>' 

0DH  ;Terminate  the  message 
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Sample  Program  G,  continued 


00201  EPROMPTiDEFM  '[Extended  Command  Interpreter  Is  Now  Disabled]' 

00202  DEFB  0DH 
00203 

00204  CMDTXT:  DEFM  "CMD" 

00205  BUFFER:  DEFS  11  ;Allow  for  filename,  drivespec  and  0DH 
00206 

00207  END  BEGIN  ; "BEGIN"  is  the  starting  address 


i 
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Commands  and  Utilities 


TRSDOS  commands  and  utilities  are  covered  extensively  in  the  Disk  System 
Owner's  Manual.  This  section  presents  additional  information  of  a  technical 
nature  on  several  of  the  commands  and  utilities. 


Changing  the  Step  Rate 


The  step  rate  is  the  rate  at  which  the  drive  head  moves  from  cylinder  to  cylinder. 
You  can  change  the  step  rate  for  any  drive  by  using  one  of  the  commands 
described  below. 

To  set  the  step  rate  for  a  particular  drive,  use  the  following  command: 

SYSTEM  (DRIVE  =  drive,  STEP  =  number) 

drive  is  any  drive  enabled  in  the  system,  number  can  be  0,  1,  2,  or  3  and  rep- 
resents one  of  the  following  step  rates  in  milliseconds: 

0=  6  milliseconds 
1  =  12  milliseconds 
2 =20  milliseconds 
3  =  30  milliseconds 

Unless  it  is  SYSGENed,  the  step  value  you  select  remains  in  effect  for  the  spec- 
ified drive  only  until  the  system  is  re-booted  or  turned  off.  If  you  use  the 
SYSGEN  command  while  the  step  value  is  in  effect,  then  this  step  rate  is  written 
to  the  configuration  file  (CONFIG/SYS)  on  the  disk  in  the  drive  specified  by  the 
SYSGEN  command. 

On  a  new  TRSDOS  disk,  the  step  rate  is  set  to  12  milliseconds. 

To  set  the  default  bootstrap  step  rate  used  with  the  FORMAT  utility,  use  the  fol- 
lowing command: 

SYSTEM  (BSTEP  =  number) 

number  is  0,  1,  2,  or  3,  which  correspond  to  6,  12,  20,  and  30  milliseconds, 
respectively. 

The  value  you  select  for  number  is  stored  in  the  system  information  sector  on 
the  disk  in  Drive  0.  (On  a  new  TRSDOS  disk,  the  bootstrap  step  rate  is  set  to  12 
milliseconds.) 

If  you  switch  Drive  0  disks  or  change  the  logical  Drive  0  with  the  SYSTEM 
(SYSTEM)  command,  the  default  value  is  taken  off  the  new  Drive  0  disk  if  you 
format  a  disk. 

You  can  change  the  bootstrap  step  rate  for  a  particular  FORMAT  operation  if 
you  do  not  want  to  use  the  default.  Specify  the  new  value  for  STEP  on  the 
FORMAT  command  line  as  follows: 

FORMAT  -.drive  {STEP  =  number) 

drive  is  the  drive  to  be  used  for  the  FORMAT,  number  is  0, 1, 2,  or  3,  which  cor- 
respond to  6, 12,  20,  and  30  milliseconds,  respectively. 

The  step  rate  is  important  only  if  you  will  be  using  the  disk  in  Drive  0  to  start  up 
the  system.  Keep  in  mind  that  too  low  a  step  rate  may  keep  the  disk  from 
booting. 
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Changing  the  WAIT  Value 


The  WAIT  parameter  compensates  for  hardware  incompatibility  between  cer- 
tain disk  drives.  The  only  time  you  should  use  it  is  when  all  tracks  above  a  cer- 
tain point  during  a  FORMAT  operation  are  shown  as  locked  out  when  the 
FORMAT  is  verified. 

The  value  assigned  to  WAIT  signifies  the  amount  of  time  between  the  arrival  of 
the  drive  head  at  the  location  for  a  read  or  write,  and  the  actual  start  of  the  read 
or  write. 

If  you  want  to  change  the  WAIT  value,  specify  the  new  value  on  the  FORMAT 
command  line  as  follows: 

FORMAT  -.drive  (WAIT  =  number) 

number  is  a  value  between  5000  and  50000.  The  exact  value  depends  on  the 
particular  disk  drive  you  are  using.  We  recommend  that  you  use  a  value  around 
25000  at  first.  Adjust  this  value  higher  if  tracks  are  still  locked  out,  or  lower  until 
the  bottom  limit  is  determined. 


Logging  in  a  Diskette 


LOG  is  a  utility  program  that  logs  in  the  directory  track,  number  of  sides,  and 
density  of  a  diskette.  The  syntax  is: 

LOG  -.drive 

drive  is  any  drive  currently  enabled  in  the  system. 

The  LOG  utility  provides  a  way  to  log  in  diskette  information  and  update  the 
drive's  Drive  Code  Table  (DCT).  It  performs  the  same  log-in  function  as  the 
DEVICE  library  command,  except  for  a  single  drive  rather  than  all  drives.  It  also 
provides  a  way  to  swap  the  Drive  0  diskette  for  a  double-sided  diskette. 

The  LOG  :0  command  prompts  you  to  switch  the  Drive  0  diskette.  You  must  use 
this  command  when  switching  between  double-  and  single-sided  diskettes  in 
Drive  0.  Otherwise,  it  is  not  needed. 

Example 

If  you  want  to  switch  disks  in  Drive  0,  type: 

LOG    :0    (ENTER) 

The  system  prompts  you  with  the  message: 

Exchange  disks  and  hit  <ENTER> 

Remove  the  current  disk  from  Drive  0  and  insert  the  new  system  disk.  When 
you  press  (ENTER),  information  about  the  new  disk  is  entered  to  the  system. 


Printing  Graphics  Characters 


If  your  printer  is  capable  of  directly  reproducing  the  TRS-80  graphics  charac- 
ters, you  can  use  the  SYSTEM  (GRAPHIC)  command.  Once  you  have  issued 
this  command,  any  graphics  characters  on  the  screen  will  be  sent  to  the  line 
printer  during  a  screen  print.  {Pressing  (ETRTJfn  causes  the  contents  of  the 
video  display  to  be  printed  on  the  printer.) 

Do  not  use  this  command  unless  your  printer  is  capable  of  directly  reproducing 
the  TRS-80  graphics  characters. 


C 
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Changing  the  Clock  Rate 


i 


The  system  normally  runs  at  the  fast  clock  rate  of  4  megahertz. 

A  slow  mode  of  2  megahertz  is  available,  and  may  be  necessary  for  real  time- 
dependent  programs.  (This  slow  rate  is  the  same  as  the  Model  III  clock  rate.) 

To  switch  to  the  slow  rate,  enter  the  following  command: 

SYSTEM  (SLOW) 
To  switch  back  to  the  fast  rate,  enter: 

SYSTEM  (FAST) 


■s 
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Appendix  A/TRSDOS  Error  Messages 


if  the  computer  displays  one  of  the  messages  listed  in  this  appendix,  an  oper- 
ating system  error  occurred.  Any  other  error  message  may  refer  to  an  applica- 
tion program  error,  and  you  should  check  your  application  program  manual  for 
an  explanation. 

When  an  error  message  is  displayed: 

•  Try  the  operation  several  times. 

•  Look  up  operating  system  errors  below  and  take  any  recommended 
actions.  (See  your  application  program  manual  for  explanations  of  appli- 
cation program  errors.) 

•  Try  using  other  diskettes. 

•  Reset  the  computer  and  try  the  operation  again. 

•  Check  all  the  power  connections. 

•  Check  all  interconnections. 

•  Remove  all  diskettes  from  drives,  turn  off  the  computer,  wait  15  seconds, 
and  turn  it  on  again. 

•  If  you  try  all  these  remedies  and  still  get  an  error  message,  contact  a 
Radio  Shack  Service  Center. 

Note:  If  there  is  more  than  one  thing  wrong,  the  computer  might  wait  until  you 
correct  the  first  error  before  displaying  the  second  error  message. 

This  list  of  error  messages  is  alphabetical,  with  the  binary  and  hexadecimal 
error  numbers  in  parentheses.  Following  it  is  a  quick  reference  list  of  the  mes- 
sages arranged  in  numerical  order. 

Attempted  to  read  locked/deleted  data  record  (Error  7,  X'07*) 

In  a  system  that  supports  a  "deleted  record"  data  address  mark,  an  attempt  was 
made  to  read  a  deleted  sector.  TRSDOS  currently  does  not  use  the  deleted 
sector  data  address  mark.  Check  for  an  error  in  your  application  program. 

Attempted  to  read  system  data  record  (Error  6,  X'06') 

An  attempt  was  made  to  read  a  directory  cylinder  sector  without  using  the 
directory  read  routines.  Directory  cylinder  sectors  are  written  with  a  data 
address  mark  that  differs  from  the  data  sector's  data  address  mark.  Check  for 
an  error  in  your  application  program. 

Data  record  not  found  during  read  (Error  5,  X'05') 

The  sector  number  for  the  read  operation  is  not  on  the  cylinder  being  refer- 
enced. Either  the  disk  is  flawed,  you  requested  an  incorrect  number,  or  the  cyl- 
inder is  improperly  formatted.  Try  the  operation  again.  If  it  fails,  use  another 
disk.  Reformatting  the  old  disk  should  lock  out  the  flaw. 

Data  record  not  found  during  write  (Error  13,  X'OD') 

The  sector  number  requested  for  the  write  operation  cannot  be  found  on  the 
cylinder  being  referenced.  Either  the  disk  is  flawed,  you  requested  an  incorrect 
number,  or  the  cylinder  is  improperly  formatted.  Try  the  operation  again.  If  it 
fails,  use  another  disk. 

Device  in  use  (Error  39,  X'27') 

A  request  was  made  to  REMOVE  a  device  (delete  it  from  the  Device  Control 
Block  tables)  while  it  was  in  use.  RESET  the  device  in  use  before  removing  it. 


Software  193 


Device  not  available  (Error  8,  X'08') 

A  reference  was  made  for  a  logical  device  that  cannot  be  found  in  the  Device 
Control  Block.  Probably,  your  device  specification  was  wrong  or  the  device 
peripheral  was  not  ready.  Use  the  DEVICE  command  to  display  all  devices 
available  to  the  system. 

Directory  full  —  can't  extend  file  (Error  30,  X'1  E') 

A  file  has  all  extent  fields  of  its  last  directory  record  in  use  and  must  find  a  spare 
directory  slot  but  none  is  available.  (See  the  "Directory  Records"  section.)  Copy 
the  disk's  files  to  a  newly  formatted  diskette  to  reduce  file  fragmentation.  You 
may  use  backup  by  class  or  backup  reconstruct  to  reduce  fragmentation. 

Directory  read  error  (Error  17,  X'11') 

A  disk  error  occurred  during  a  directory  read.  The  problem  may  be  media,  hard- 
ware, or  program  failure.  Move  the  disk  to  another  drive  and  try  the  operation 
again. 

Directory  write  error  (Error  18,  X'12') 

A  disk  error  occurred  during  a  directory  write  to  disk.  The  directory  may  no 
longer  be  reliable.  If  the  problem  recurs,  use  a  different  diskette. 

Disk  space  full  (Error  27,  X1B) 

While  a  file  was  being  written,  all  available  disk  space  was  used.  The  disk  con- 
tains only  a  partial  copy  of  the  file.  Write  the  file  to  a  diskette  that  has  more  avail- 
able space.  Then,  REMOVE  the  partial  copy  to  recover  disk  space. 

End  of  file  encountered  (Error  28,  X'1C) 

You  tried  to  read  past  the  end  of  file  pointer.  Use  the  DIR  command  to  check  the 
size  of  the  file.  This  error  also  occurs  when  you  use  the  @PEOF  supervisor  call 
to  successfully  position  to  the  end  of  a  file.  Check  for  an  error  in  your  application 
program. 

Extended  error  (Error  63) 

An  error  has  occurred  and  the  extended  error  code  is  in  the  HL  register  pair. 

File  access  denied  (Error  25,  X'19') 

You  specified  a  password  for  a  file  that  is  not  password  protected  or  you  spec- 
ified the  wrong  password  for  a  file  that  is  password  protected. 

File  already  open  (Error  41,  X'29') 

You  tried  to  open  a  file  for  UPDATE  level  or  higher,  and  the  file  already  is  open 
with  this  access  level  or  higher.  This  forces  a  change  to  READ  access  protec- 
tion. Use  the  RESET  library  command  to  close  the  file. 

File  not  in  directory  (Error  24,  X'18') 

The  specified  filespec  cannot  be  found  in  the  directory.  Check  the  spelling  of 
the  filespec. 

File  not  open  (Error  38,  X'26') 

You  requested  an  I/O  operation  on  an  unopened  file.  Open  the  file  before 
access. 

GAT  read  error  (Error  20,  X'14') 

A  disk  error  occurred  during  the  reading  of  the  Granule  Allocation  Table.  The 
problem  may  be  media,  hardware,  or  program  failure.  Move  the  diskette  to 
another  drive  and  try  the  operation  again. 

GAT  write  error  (Error  21,  X*15') 

A  disk  error  occurred  during  the  writing  of  the  Granule  Allocation  Table.  The 
GAT  may  no  longer  be  reliable.  If  the  problem  recurs,  use  a  different  drive  or 
different  diskette. 
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HIT  read  error  (Error  22,  X'16') 

A  disk  error  occurred  during  the  reading  of  the  Hash  Index  Table.  The  problem 
may  be  media,  hardware,  or  program  failure.  Move  the  diskette  to  another  drive 
and  try  the  operation  again. 

HIT  write  error  (Error  23,  X'17') 

A  disk  error  occurred  during  the  writing  of  the  Hash  Index  Table.  The  HIT  may 
no  longer  be  reliable.  If  the  problem  recurs,  use  a  different  drive  or  different 
diskette. 

Illegal  access  attempted  to  protected  file  (Error  37,  X'25") 

The  USER  password  was  given  for  access  to  a  file,  but  the  requested  access 
required  the  OWNER  password.  (See  the  ATTRIB  library  command  in  your 
Disk  System  Owner's  Manual.) 

Illegal  drive  number  (Error  32,  X'20') 

The  specified  disk  drive  is  not  included  in  your  system  or  is  not  ready  for  access 
(no  diskette,  non-TRSDOS  diskette,  drive  door  open,  and  so  on).  See  the 
DEVICE  command  in  your  Disk  System  Owner's  Manual.) 

Illegal  file  name  (Error  19,  X'13') 

The  specified  filespec  does  not  meet  TRSDOS  filespec  requirements.  See  your 
Disk  System  Owner's  Manual  for  proper  filespec  syntax. 

Illegal  logical  file  number  (Error  16,  X'10') 

A  bad  Directory  Entry  Code  (DEC)  was  found  in  the  File  Control  Block  (FCB). 
This  usually  indicates  that  your  program  has  altered  the  FCB  improperly.  Check 
for  an  error  in  your  application  program. 

Load  file  format  error  (Error  34,  X'22') 

An  attempt  was  made  to  load  a  file  that  cannot  be  loaded  by  the  system  loader. 
The  file  was  probably  a  data  file  or  a  BASIC  program  file. 

Lost  data  during  read  (Error  3,  X'03') 

During  a  sector  read,  the  CPU  did  not  accept  a  byte  from  the  Floppy  Disk  Con- 
troller (FDC)  data  register  in  the  time  allotted.  The  byte  was  lost.  This  may  indi- 
cate a  hardware  problem  with  the  drive.  Move  the  diskette  to  another  drive  and 
try  again.  If  the  error  recurs,  try  another  diskette. 

Lost  data  during  write  (Error  11,  X'QB') 

During  a  sector  write,  the  CPU  did  not  transfer  a  byte  to  the  Floppy  Disk  Con- 
troller (FDC)  in  the  time  allotted.  The  byte  was  lost;  it  was  not  transferred  to  the 
disk.  This  may  indicate  a  hardware  problem  with  the  drive.  Move  the  diskette  to 
another  drive  and  try  again.  If  the  error  recurs,  try  another  diskette. 

LRL  open  fault  (Error  42,  X'2A') 

The  logical  record  length  specified  when  the  file  was  opened  is  different  than 
the  LRL  used  when  the  file  was  created.  COPY  the  file  to  another  file  that  has 
the  specified  LRL. 

No  device  space  available  (Error  33,  X'21') 

You  tried  to  SET  a  driver  or  filter  and  all  of  the  Device  Control  Blocks  were  in 
use.  Use  the  DEVICE  command  to  see  if  any  non-system  devices  can  be 
removed  to  provide  more  space.  This  error  also  occurs  on  a  "global"  request  to 
initialize  a  new  file  (that  is,  no  drive  was  specified),  if  no  file  can  be  created. 

No  directory  space  available  (Error  26,  X'1  A') 

You  tried  to  open  a  new  file  and  no  space  was  left  in  the  directory.  Use  a  differ- 
ent disk  or  REMOVE  some  files  that  you  no  longer  need. 
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No  error  (Error  0) 

The  @ERROR  supervisor  call  was  called  without  any  error  condition  being 
detected.  A  return  code  ot  zero  indicates  no  error.  Check  for  an  error  in  your 
application  program. 

Parameter  error  (Error  44,X'2C) 

(Under  Version  6.2  only)  An  error  occurred  while  executing  a  command  line  or 
utility  because  a  parameter  that  does  not  exist  was  specified.  Check  the  spell- 
ing of  the  parameter  name,  value,  or  abbreviation. 

Parity  error  during  header  read  (Error  1,  X'OT) 

During  a  sector  I/O  request,  the  system  could  not  read  the  sector  header  suc- 
cessfully. If  this  error  occurs  repeatedly,  the  problem  is  probably  media  or  hard- 
ware failure.  Try  the  operation  again,  using  a  different  drive  or  diskette. 

Parity  error  during  header  write  (Error  9,  X'09') 

During  a  sector  write,  the  system  could  not  write  the  sector  header  satisfactor- 
ily. If  this  error  occurs  repeatedly,  the  problem  is  probably  media  or  hardware 
failure.  Try  the  operation  again,  using  a  different  drive  or  diskette. 

Parity  error  during  read  (Error  4,  X'04') 

An  error  occurred  during  a  sector  read.  Its  probable  cause  is  media  failure  or  a 
dirty  or  faulty  disk  drive.  Try  the  operation  again,  using  a  different  drive  or 
diskette. 

Parity  error  during  write  (Error  12,  X'OC) 

An  error  occurred  during  a  sector  write  operation.  Its  probable  cause  is  media 
failure  or  a  dirty  or  faulty  disk  drive.  Try  the  operation  again,  using  a  different 
drive  or  diskette. 

Program  not  found  (Error  31,  X'1  P) 

The  file  cannot  be  loaded  because  it  is  not  in  the  directory.  Either  the  filespec 
was  misspelled  or  the  disk  that  contains  the  file  was  not  loaded. 

Protected  system  device  (Error  40,  X'28') 

You  cannot  REMOVE  any  of  the  following  devices:  *KI,  *DO,  *PR,  *JL,  *SI,  *SO. 
If  you  try,  you  get  this  error  message. 

Record  number  out  of  range  (Error  29,  X'1  D') 

A  request  to  read  a  record  within  a  random  access  file  (see  the  @POSN  super- 
visor call)  provided  a  record  number  that  was  beyond  the  end  of  the  file.  Correct 
the  record  number  or  try  again  using  another  copy  of  the  file. 

Seek  error  during  read  (Error  2,  X'02') 

During  a  read  sector  disk  t/O  request,  the  cylinder  that  should  contain  the  sec- 
tor was  not  found  within  the  time  allotted.  (The  time  is  set  by  the  step  rate  spec- 
ified in  the  Drive  Code  Table.)  Either  the  cylinder  is  not  formatted  or  it  is  no 
longer  readable,  or  the  step  rate  is  too  low  for  the  hardware  to  respond.  You  can 
set  an  appropriate  step  rate  using  the  SYSTEM  library  command.  The  problem 
may  also  be  caused  by  media  or  hardware  failure.  In  this  case,  try  the  operation 
again,  using  a  different  drive  or  diskette. 

Seek  error  during  write  (Error  10,  X'OA') 

During  a  sector  write,  the  cylinder  that  should  contain  the  sector  was  not  found 
within  the  time  allotted.  (The  time  is  set  by  the  step  rate  specified  in  the  Drive 
Code  Table.)  Either  the  cylinder  is  not  formatted  or  it  is  no  longer  readable,  or 
the  step  rate  is  too  low  for  the  hardware  to  respond.  You  can  set  an  appropriate 
step  rate  using  the  SYSTEM  library  command.  The  problem  may  also  be 
caused  by  media  or  hardware  failure.  In  this  case,  try  the  operation  again,  using 
a  different  drive  or  diskette. 
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—  Unknown  error  code 

The  @ERROR  supervisor  call  was  called  with  an  error  number  that  is  not 
defined.  Check  for  an  error  in  your  application  program. 

Write  fault  on  disk  drive  (Error  14,  X'OE') 

An  error  occurred  during  a  write  operation.  This  probably  indicates  a  hardware 
problem.  Try  a  different  diskette  or  drive.  If  the  problem  continues,  contact  a 
Radio  Shack  Service  Center. 

Write  protected  disk  (Error  15,  X'OF) 

You  tried  to  write  to  a  drive  that  has  a  write-protected  diskette  or  is  software 
write-protected.  Remove  the  write-protect  tab,  if  the  diskette  has  one.  If  it  does 
not,  use  the  DEVICE  command  to  see  if  the  drive  is  set  as  write  protected.  If  it 
is,  you  can  use  the  SYSTEM  library  command  with  the  (WP  =  OFF)  parameter 
to  write  enable  the  drive.  If  the  problem  recurs,  use  a  different  drive  or  different 
diskette. 

Numerical  List  of  Error  Messages 

Message 

No  Error 

Parity  error  during  header  read 

Seek  error  during  read 

Lost  data  during  read 

Parity  error  during  read 

Data  record  not  found  during  read 

Attempted  to  read  system  data  record 

Attempted  to  read  locked/deleted  data  record 

Device  not  available 

Parity  error  during  header  write 

Seek  error  during  write 

Lost  data  during  write 

Parity  error  during  write 

Data  record  not  found  during  write 

Write  fault  on  disk  drive 

Write  protected  disk 

Illegal  logical  file  number 

Directory  read  error 

Directory  write  error 

Illegal  file  name 

GAT  read  error 

GAT  write  error 

HIT  read  error 

HIT  write  error 

File  not  in  directory 

File  access  denied 

No  directory  space  available 

Disk  space  full 

End  of  file  encountered 

Record  number  out  of  range 

Directory  full — can't  extend  file 

Program  not  found 

Illegal  drive  number 

No  device  space  available 

Load  file  format  error 

Illegal  access  attempted  to  protected  file 

File  not  open 

Device  in  use 

Protected  system  device 
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Decimal 

Hex 

0 

X00' 

1 

X'01' 

2 

X02' 

3 

X'03' 

4 

X04' 

5 

X'05' 

6 

X06' 

7 

X'07* 

8 

X'08' 

9 

X'09' 

10 

X'OA' 

11 

X'OB' 

12 

X'OC 

13 

X'OD' 

14 

X'OE' 

15 

X'OF' 

16 

X'10' 

17 

x'ir 

18 

X'12* 

19 

X'13' 

20 

X'14' 

21 

X'15' 

22 

X'16' 

23 

X'17' 

24 

X'18' 

25 

X'19' 

26 

X'1A' 

27 

X'1B' 

28 

X'1C 

29 

X'1D' 

30 

X'1E' 

31 

X'1F 

32 

X'20' 

33 

X'21' 

34 

X'22' 

37 

X'25' 

38 

X'26' 

39 

X'27' 

40 

X'28' 

41  X'29'  File  already  open 

42  X2A'  LRL  open  fault 

43  X'2B'  SVC  parameter  error 

44  X'2C  Parameter  error 
63  X'3F  Extended  error 

—  Unknown  error  code 


C 
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Appendix  B/Memory  Map 


i 


OPTIONAL         / 

64K  MEMORY  ^       32K 


^J 


64K 


BANK1 


BANK  2 


'2400H 

I2600HI 

3000H 


SYSTEM  BANK 


BANK0 


ft, 


lilliiilillMil  llilnil 


Resident  operating  system,  system 
buffers,  overlays,  drivers,  etc. 


Library  overlay  zone 


Note:  2400H  to  2600H  is 
reserved  for  possible  future 
expansion  of  the  resident 
operating  system  area. 


32K 


64K 


HIGHS 


All  software  must  observe  HIGHS. 

User  software  which  does  not  allow  TRSDOS  library  commands  to  be  executed 
during  run  time  may  use  memory  from  2600H  to  HIGHS. 

User  software  which  allows  for  library  commands  during  execution  must  reside 
in  and  use  memory  only  between  3000H  and  HIGH$. 

TRSDOS  provides  all  functions  and  storage  through  supervisor  calls.  No 
address  or  entry  point  below  3000H  is  documented  by  Radio  Shack. 
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Appendix  C/Character  Codes 


Text,  control  functions,  and  graphics  are  represented  in  the  computer  by  codes. 
The  character  codes  range  from  zero  through  255. 


i 


Codes  one  through  31  normally  represent  certain  control  functions.  For  exam- 
ple, code  13  represents  a  carriage  return  or  "end  of  line:'  These  same  codes 
also  represent  special  characters.  To  display  the  special  character  that  corre- 
sponds to  a  particular  code  (1-31 ),  precede  the  code  with  a  code  zero. 

Codes  32  through  127  represent  the  text  characters  —  all  those  letters,  num- 
bers, and  other  characters  that  are  commonly  used  to  represent  textual 
information. 

Codes  128  through  191,  when  output  to  the  video  display,  represent  64  graphics 
characters. 

Codes  192  through  255,  when  output  to  the  video  display,  represent  either 
space  compression  codes  or  special  characters,  as  determined  by  software. 


***// 
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ASCII  Character  Set 


Code  ASCII 

Dec.     Hex.     Abbrev. 

0       00        NUL 


Keyboard 

(HED© 


1 

01 

SOH 

(CTROfff) 

2 

02 

STX 

(cnom 

3 

03 

ETX 

(CtHL)ft) 

4 

04 

EOT 

GTRDffl) 

5 

05 

ENQ 

CHBDCB 

6 

06 

ACK 

(CTRDfFl 

7 

07 

BEL 

(CTRCME) 

8 

08 

BS 

® 
(CTRLKH) 

9 

09 

HT 

® 
(□BEXD 

10 

0A 

LF 

(CTffDfJ) 

11 

OB 

VT 

© 
(CTHDflE) 

12 

0C 

FF 

(5TRTXD 

13 

00 

CR 

(INTER) 

(CTRDd) 

14 

0E 

SO 

(CTRDfli) 

15 

0F 

SI 

(HEEXE 

16 

10 

DLE 

oaBD® 

17 

11 

DC1 

(ETrTXB) 

18 

12 

DC2 

(CTRD(R) 

19 

13 

DC3 

OED® 

20 

14 

DC4 

(CTRCim 

21 

15 

NAK 

fETRCXU) 

22 

16 

SYN 

(Ctrl)OO 

23 

17 

ETB 

fCTRDffl 

24 

18 

CAN 

(SHIFT)® 

(ETRDffi 

25 

19 

EM 

(SHIFT)® 
(HED® 

26 

1A 

SUB 

(SBJEE© 
(HED© 

27 

1B 

ESC 

(SHIFTY*"] 
(CTRDfT) 

28 

1C 

FS 

(ETRDm 

29 

1D 

GS 

(HEDfEHTEff) 
OBDQ 

30 

1E 

RS 

(tTRL)f ; ) 

Video  Display 

Treat  next  character  as  dis- 
playable;  if  in  the  range  1-31, 
a  special  character  is  dis- 
played (see  list  of  special 
characters  later  in  this 
Appendix). 


Backspace  and  erase 


Move  cursor  to  start  of  next 
line 


Move  cursor  to  start  of  next 

line 

Turn  cursor  on 

Turn  cursor  off 

Enable  reverse  video  and 

set  high  bit  routine  on* 

Set  reverse  video  high  bit 

routine  off* 


Swap  space  compression/ 

special  characters 

Swap  special/alternate 

characters 

Set  to  40  characters  per  line 

Backspace  without  erasing 

Advance  cursor 

Move  cursor  down 

Move  cursor  up 

Move  cursor  to  upper  left 
corner.  Disable  reverse 
video  and  set  high  bit  rou- 
tine off.*  Set  to  80  charac- 
ters per  line. 

Erase  line  and  start  over 
Erase  to  end  of  line 


*When  the  high  bit  routine  is  on,  characters  128  through  191  are  displayed  as 
standard  ASCII  characters  in  reverse  video. 


O 


v 
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Code 

ASCII 

Dec. 

Hex. 

Abbrev. 

Keyboard 

Video  Display 

31 

1F 

vs 

(SHIFTXCLEAR) 

Erase  to  end  of  display 

32 

20 

SPA 

(SPACEBAR) 

(blank) 

33 

21 

© 

! 

34 

22 

CD 

M 

35 

23 

© 

# 

36 

24 

® 

$ 

37 

25 

® 

% 

38 

26 

® 

& 

39 

27 

CD 

* 

40 

28 

CD 

( 

41 

29 

CD 

) 

42 

2A 

CD 

* 

43 

2B 

© 

+ 

44 

2C 

CD 

r 

45 

2D 

© 

- 

46 

2E 

CD 

* 

47 

2F 

© 

/ 

48 

30 

9) 

0 

49 

31 

(D 

1 

50 

32 

® 

2 

51 

33 

<$ 

3 

52 

34 

® 

4 

53 

35 

® 

5 

54 

36 

® 

6 

55 

37 

m 

7 

56 

38 

® 

8 

57 

39 

® 

9 

58 

3A 

© 

I 

59 

3B 

© 

* 

60 

3C 

© 

< 

61 

3D 

© 

= 

62 

3E 

© 

> 

63 

3F 

© 

? 

64 

40 

(D 

@ 

65 

41 

(gRTFDfl) 

A 

66 

42 

(MFD® 

B 

67 

43 

(SHIFT)© 

C 

68 

44 

(SHIFT)® 

D 

69 

45 

(SUlFPfE) 

E 

70 

46 

(SHIFT)© 

F 

71 

47 

rsfliFDrtn 

G 

72 

48 

(SfflFTKK) 

H 

73 

49 

(SfllFTKD 

I 

74 

4A 

($HIF?KD 

J 

75 

4B 

&HED® 

K 

76 

4C 

rgnFf)(D 

L 

77 

4D 

(SHIED® 

M 

78 

4E 

(Shied® 

N 

79 

4F 

(SHIFT)® 

O 

80 

50 

(ffllFIXB 

P 

81 

51 

(5TCFT)® 

Q 

82 

52 

(SHIFT)® 

R 

83 

53 

(SHE)® 

S 

84 

54 

SHED® 

T 

85 

55 

(SHIFT)® 

U 

86 

56 

(SHED® 

V 

87 

57 

(SHED® 

w 

88 

58 

(SHED® 

X 

89 

59 

(SHED® 

Y 
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Code            ASCII 

Dec. 

Hex.     Abbrev.     Keyboard 

Video  Display 

90 

5A 

(SHIFT)® 

Z 

91 

5B 

(HOTKD 

f 

92 

5C 

mm(D 

\ 

93 

5D 

(CLEAR)Q 

] 

94 

5E 

(CLEAftim 

95 

5F 

fCLEAftXENTERl 

— 

96 

60 

(SEED© 

97 

61 

® 

a 

98 

62 

(D 

b 

99 

63 

© 

c 

100 

64 

® 

d 

101 

65 

© 

e 

102 

66 

© 

f 

103 

67 

© 

g 

104 

68 

© 

h 

105 

69 

d> 

i 

106 

6A 

GD 

i 

107 

6B 

® 

k 

108 

6C 

(D 

1 

109 

6D 

(D 

m 

110 

6E 

1) 

n 

111 

6F 

© 

o 

112 

70 

® 

p 

113 

71 

© 

q 

114 

72 

© 

r 

115 

73 

(S) 

s 

116 

74 

(D 

t 

117 

75 

CD) 

u 

118 

76 

(!) 

V 

119 

77 

© 

w 

120 

78 

® 

X 

121 

79 

(B 

y 

122 

7A 

© 

z 

123 

7B 

(CLEARKSHIFDm 

{ 

124 

7C 

(CLEAR)(SHIFT)(Tl 

1 

125 

7D 

(C|-EAR)(SHiei)0 

} 

126 

7E 

7F        DEL 

(KEffiKSHEDCD 

127 

■r<*WDMWaJii£iHim 

± 

/*"*"% 

Ly 


^^ 
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Extended  (non-ASCII)  Character  Set 


Code 

Dec. 

Hex. 

Keyboard 

128 

80 

(BREAK) 

129 

81 

(ED 

(CLEARKCTRLKAl 

130 

82 

<H> 

(Craffi)(ETRL)(Fl 

131 

83 

(CLEARHCTRUfEl 

132 

84 

(CLEAR)(CTRL)(b) 

133 

85 

(dLEAR)(CTHL)(E) 

134 

86 

(CLEARKCTRLKF) 

135 

87 

(CLEARHCTRUG) 

136 

88 

(CLEARHCTRLXH) 

137 

89 

(CLtAR)(dTRL)(I) 

138 

8A 

(£LEABX£IRJJUJ 

139 

8B 

(CLEARHfcTRLKK) 

140 

8C 

(CLEARKCTRLKL) 

141 

8D 

(ELEAffiflfflOin 

142 

8E 

(CLEARNCTRLKN) 

143 

8F 

(CLEARKCYRUA) 

144 

90 

(£LEAffi(ETRri(Fl 

145 

91 

(SHIFTKFD 
[gCEffiKCTRDfffl 

146 

92 

C5H1FD(E2) 
(CLEARKFffOHl 

147 

93 

(SHlFtKFS) 
(CLEAR)(CTRL)(51 

148 

94 

(BlffiXnRDU 

149 

95 

[gtHRlCETRDOn 

150 

96 

rCCETOfitCTRLirV) 

151 

97 

(CLEARXCTRLXW) 

152 

98 

(tma)(£iBjjQC 

153 

99 

(CCHR)(CTRT)(Y) 

154 

9A 

(CLHRirtrraod) 

155 

9B 

[£L£ft6)(SHffD(*J 

156 

9C 

157 

9D 

158 

9E 

159 

9F 

160 

A0 

(iJCEAUKSPIpf) 

161 

A1 

(CLEAft)fSHlFT)(1) 

162 

A2 

(CCBTOCSHffnS) 

163 

A3 

(CUHRltSHTFTJlTi 

164 

A4 

[CLEAHifanmai 

165 

A5 

aa^HKfflnn® 

166 

A6 

ftCBODt^HlFDlg) 

167 

A7 

(CCHBX5HIFTX7} 

168 

A8 

fCtEWKSHlFW! 

169 

A9 

«mSRl(SHlFT)(S1 

170 

AA 

(CCESffiOilFDm 

171 

AB 

172 

AC 

173 

AD 

(fiJJAfi)(jlJ 

174 

AE 

175 

AF 

176 

B0 

(SEE)® 

177 

B1 

(£BB)CD 

178 

B2 

(SHE)® 
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Video  Display 


>< 

C 
Q. 

a. 
< 


X) 
CD 

** 

a 

.c 
o 

s 

jr 

Q. 

£5 
o> 

03 

<n 


o 


o 


cm 


B8B88|SN|SgB|S|SK|S!8!2!2ti!2!S2!2!2!S!2 

£uN-^ocoa»vjo>cn.ttcoro-tsco(»viooi.ucoro-t@ 


"     C!!!!!!!^!SI5TP!!!3mS!OOOOOODODOCiDODDDOOOOOOOOOooooooo!i)tDaigBmngai5(iicproi» 
3-     >woo^o)w^caiv>^©^rTioooD>tooo-Nio)oi^«ro-'o-nmooaj><Da>'vio'0,-*iWM-i©TirTiooOD>(oco^o)w,*kW  jg 


toN>roi\jroN>roiotoi\>-'>-'>-^-^-^-^-i-^-i-i-'-'-'--i-'-'-i-i-'-'-'> 

SS9SG9S0900(0(OIO<0(0<D<0(OII)COO)(XIOOOOCO«000)OaS 
CD00->J0>01JkC0r0-*©<00J-^J0)Ul4iG0IU-'©(000-^0)01*.C0r0-*OC0 


n  n  o  n  »  n  n 


88®@@©8@@@®@@@e@©e@@@©@@@© 


0) 


See  list  of  special  characters  in  this  Appendix. 


See  g  raph  Ics  character  table  in    2" 
this  Appendix.  * 

w 

■o 


3 


fl> 


O 


• 


Code 

Dec. 

Hex. 

Keyboard 

Video  Display 

235 

EB 

(CLFJlRWSHlFTKK) 

X 

236 

EC 

(CLEARKSHIFTML) 

T3 

237 

ED 

(CLEAR)($HIFTXM) 

© 

238 

EE 

rcnamHSHiFDfffi 

O. 

239 

EF 

fCCESnifsHimrtJ) 

240 

F0 

[CLEARKSHIFTKP] 

.C 

241 

F1 

fCLEARHSHIFTKQ) 

c 

242 

F2 

(CLEARHSHIfTKR) 

(0 

243 

F3 

(CLtARKSHlFTKS) 

2 

244 

F4 

(CLEAR)tSHIFTKT) 

£ 

245 

F5 

(CLEAR)[$HIFT)(U) 

to 

246 

F6 

(CLEAR)(SHlFt)(V) 

o 

247 

F7 

(CCERR)(SR1FTI(W) 

to 
o 

248 

F8 

(CLEARlfSHlfTKX) 

Q. 

249 

F9 

(CLEARKSMIFTKY) 

CO 

250 

FA 

(£kEARJ(SHlED(D 

o 

253 

FD 

w 

254 

FE 

255 

FF 

CO 

<^^r 
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Graphics  Characters  (Codes  128-191) 


"  * 

■" 

■"* 

^ 

** 

*  ■ 

T" 

■ 

*■ 

■ 

'  " 

Ul 

PI 

■ 

■ 

■ 

■ 

-ft 

-« 

1-4 

-wi 

-m 

— m- 

-r* 

«r 

■ 

4 

m 

s 

■ 

■ 

p 

P 

■ 

T 

l 

o 
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% 


Special  Characters  (0-31,  192-255) 


0  1  2  3  4  5  6  7 


0Cln  saff  AS 

8                 9                10  11                12               13  14               15 

WOtfoBuoE 

16                17               18  19               20               21  22              23 

24               25               26  27               28               29  30               31 

192      193      194  195      196      197  198     199 

200      201      202  203      204      205  206     207 
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208     209     210     211     212     213     214     215 
216     217     218      219      220     221      222     223 


224     225     226      227      228     229     230     231 


240     241  242  243     244     245  246  247 

C/ji  n  OH  4  4  rt 

>&tf  ¥  TBI  ?v  ffi  H 

248     249  250  251     252     253  254  255 


O 
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Appendix  D/Keyboard  Code  Map 


The  keyboard  code  map  shows  the  code  that  TRSDOS  returns  for  each  key,  in 
each  of  the  modes:  control,  shift,  unshift,  clear  and  control,  clear  and  shift,  clear 
and  unshift. 

For  example,  pressing  (clear).  (SHIFT),  and  CD  at  the  same  time  returns  the  code 
X'A1: 

A  program  executing  under  TRSDOS  —  for  example,  BASIC  —  may  translate 
some  of  these  codes  into  other  values.  Consult  the  program's  documentation 
for  details. 

(BREAK)  Key  Handling 

The  (BREAK)  key  (X'80')  is  handled  in  different  ways,  depending  on  the  settings 
of  three  system  functions.  The  table  below  shows  what  happens  for  each  com- 
bination of  settings. 

Break         Break         TVPe_ 
oreaK       VectQ|.       Ahead 

Set       Enabled 


Enabled 


N  Y  If  characters  are  in  the  type-ahead  buffer, 

then  the  buffer  is  emptied* 


If  the  type-ahead  buffer  is  empty,  then  a 
BREAK  character  {X'80')  is  placed  in  the 
buffer.* 


N  N  A  BREAK  character  (XW)  is  placed  in  the 

buffer. 


The  type-ahead  buffer  is  emptied  of  its  con- 
tents (if  any),  and  control  is  transferred  to  the 
address  in  the  BREAK  vector  (see  @BREAK 
SVC).' 


Y              Y              N          Control  is  transferred  to  the  address  in  the 
BREAK  vector  (see  ©BREAK  SVC). 

N               X               X          No  action  is  taken  and  characters  in  the  type- 
ahead  buffer  are  not  affected. 

'Because  the  (BREAK)  key  is  checked  for  more  frequently  than  other  keys  on  the 
keyboard,  it  is  possible  for  (BREAK)  to  be  pressed  after  another  key  on  the  key- 
board and  yet  be  detected  first. 

Y  means  that  the  function  is  on  or  enabled 
N  means  that  the  function  is  off  or  disabled 
X  means  that  the  state  of  the  function  has  no  effect 

Break  is  enabled  with  the  SYSTEM  (BREAK  =  ON)  command  (this  is  the 

default  condition). 
The  break  vector  is  set  using  the  @BREAK  SVC  (normally  off). 
Type-ahead  is  enabled  using  the  SYSTEM  (TYPE  =  ON)  command  (this  is  the 

default  condition). 
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Appendix  E/Programmable  SVCs 

(Under  Version  6.2  only) 

SVC  numbers  124  through  127  are  reserved  for  programmer  installable  SVCs. 
To  install  an  SVC  the  programmer  must  write  the  routine  to  execute  when  the 
SVC  is  called. 

The  routine  should  be  written  as  high  memory  module  if  it  is  to  be  available  at 
all  times.  If  you  execute  a  SYSGEN  command  when  a  programmable  SVC  is 
defined,  the  address  of  the  routine  is  saved  in  the  SYSGEN  file  and  restored 
each  time  the  system  is  configured.  If  the  routine  is  a  high  memory  module,  the 
routine  is  saved  and  restored  as  well.  This  makes  the  SVC  always  available. 
For  more  information  on  high  memory  modules,  see  Memory  Header  and  Sam- 
ple Program  F. 

To  install  an  SVC,  the  program  must  access  the  SVC  table.  The  SVC  table  con- 
tains 1 28  two-byte  positions,  a  two-byte  position  for  each  usable  SVC.  Each  po- 
sition in  the  table  contains  the  address  of  the  routine  to  execute  when  the  SVC 
is  called. 

To  access  the  SVC  table,  execute  the  ©FLAGS  SVC  {SVC  101).  IY-i-26  con- 
tains the  MSB  of  the  SVC  table  start  address.  The  LSB  of  the  SVC  table  ad- 
dress is  always  0  because  the  SVC  table  always  begins  on  a  page  boundary. 

Store  the  address  of  the  routine  to  be  executed  at  the  SVC  number  times  2  byte 
in  the  table.  For  example,  if  you  are  installing  SVC  1 26,  store  the  address  of  the 
routine  at  byte  252  in  the  table.  Addresses  are  stored  in  LSB-MSB  format. 

When  the  SVC  is  executed,  control  is  transferred  to  the  address  in  the  table.  On 
entry  to  your  SVC,  Register  A  contains  the  same  value  as  Register  C.  All  other 
registers  retain  the  values  they  had  when  the  RST  28  SVC  instruction  was 
executed. 

To  exit  the  SVC,  execute  a  RET  instruction.  The  program  should  save  and  re- 
store any  registers  used  by  the  SVC. 

Initially,  SVCs  124  through  127  display  an  error  message  when  they  are  exe- 
cuted. When  installing  an  SVC  you  should  save  the  original  address  at  that  lo- 
cation in  the  table  and  restore  it  when  you  remove  the  SVC. 

These  program  lines  insert  a  new  SVC  into  the  system  SVC  table,  save  the  pre- 
vious value  of  the  table,  and  reinsert  that  value  before  execution  ends.  You 
could  check  the  existing  value  to  see  if  the  address  is  above  X'2600'.  If  it  is,  the 
SVC  is  already  assigned  and  should  not  be  used  at  this  time. 

This  code  inserts  SVC  126,  called  MYSVC: 


LD 

A,@FLAGS 

;Locate  start  of  SVC  table 

RST 

28H 

;Execute  @  FLAGS  SVC 

LD 

H,(IY  +  26) 

;Get  MSB  of  address 

LD 

L,  126*2 

;WanttouseSVC126 

LD 

(OSVC126A),HL 

;Save  address  of  SVC  entry 

LD 

E,(HL) 

;Get  current  SVC  address 

INC 

HL 

LD 

D,(HL) 

LD 

(OSVC126V),DE 

;Save  the  old  value 

DEC 

HL 

LD 

DE.MYSVC 

;Get  address  of  routine  for 
;SVC126 

LD 

(HL),E 

;lnsert  new  SVC  address  into 
;table 

INC  HL 


Software  213 


LD  (HL),D 

.  Code  that  uses  MYSVC  (SVC  126) 


This  code  removes  SVC  1 26: 


LD 
LD 
LD 
INC 

HL,(OSVC126A) 

DE,(OSVC126V) 

(HL),E 

HL 

;Get  address  of  SVC  entry 

;Get  original  value 

;lnsert  original  SVC  address 

LD 

(HL),D 

o 
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Appendix  F/Using  SYS13/SYS 

(Under  Version  6.2  only) 

With  TRSDOS  Version  6.2,  you  can  create  an  Extended  Command  Inter- 
preter (ECI)  or  an  Immediate  Execution  Program  (IEP).  TRSDOS  can  store 
either  an  ECI  or  IEP  in  the  SYS13  file.  Both  programs  cannot  be  present  at 
the  same  time. 

At  the  TRSDOS  Ready  prompt  when  you  type  CD  (EHTEff).  TRSDOS  exe- 
cutes the  program  stored  in  SYS13/SYS.  Because  TRSDOS  recognizes  the 
program  as  a  system  file,  TRSDOS  includes  the  file  when  creating  backups 
and  loads  the  program  faster. 

If  you  want  to  write  additional  commands  for  TRSDOS,  you  can  write  an  in- 
terpreter to  execute  these  commands.  Your  ECI  can  also  execute  TRSDOS 
commands  by  using  the  @CMNDI  SVC  to  pass  a  command  to  the 
TRSDOS  interpreter. 

If  EFLAG$  contains  a  non-zero  value,  TRSDOS  executes  the  program  in 
SYS13/SYS.  If  EFLAGS  contains  a  zero,  TRSDOS  uses  its  own  command 

interpreter. 

Sample  Program  G  is  an  example  of  an  ECI.  It  is  important  to  note  that  your  ECI 
must  be  executable  by  pressing  ©  [EWTERj  at  the  TRSDOS  Ready  prompt. 

An  ECI  can  use  all  of  memory  or  you  can  restrict  it  to  use  the  system  overlay 
area  (X'26001  to  X'2FFF'). 

To  implement  an  IEP  or  ECI,  use  the  following  syntax: 


■\ 


COPY  filespec  SYS1 3/SYS.LSIDOS:dnVe  (C  =  N)  (ENTER) 

filespec  can  be  any  executable  (/CMD)  program  file,  drive  specifies  the  desti- 
nation drive.  The  destination  drive  must  contain  an  original  SYS13/SYS  file. 

Example 

COPY  SCRIPSIT/CMD:1  SYS13/SYS.LDI:©  (C  =  N) 

TRSDOS  copies  SCRIPSIT/CMD  from  Drive  1  to  SYS13/SYS  in  Drive  0.  At  the 
TRSDOS  Ready  prompt,  when  you  press  GED  CENTER).  TRSDOS  executes 
SCRIPSIT. 
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@BANK   37-39 

Bank  switching  36-39 

@BKSP    52 
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key  handling 211 

@BREAK 53 

Byte  I/O   40-42 
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codes  201-10 
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special  206-07,  209-10 

@CHNIO   54 

@CKDRV    55 
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@CKEOF    56 

@CKTSK  57 

Clock  rate,  changing  1 92 

©CLOSE  60 

@CLS    61 

@CMNDI   63 

@CMNDR   64 
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ASCII  202-04 

character 201-10 

error  1 97 

graphics    205-06,  208 

keyboard  21 1-12 

return  28 

special  character 206-07,  209-10 

Converting  to  TRSDOS  Version  6    27-28 

CREATEd  files   15 

@CTL 40-42,  65-66 


interfacing  to  device  drivers    42-44 

Cylinder 

highest  numbered  12 

number  of  18 

position,  current 12 

starting    25 

©DATE    67 

@DCINIT  68 

@DCRES    69 

@DCSTAT  70 

DEBUG    6 

@DEBUG    71 

@DECHEX    72 

Density,  double  and  single 1 ,  11,  18 

Device 

access  9-10 

handling    27 

NIL  9 

Device  Control  Block  (DCB)    9 

Device  driver 7,  8,  13 

address  9 

COM    43-44 

@CTL  interfacing  to  42-44 

keyboard  43 

printer    43 

templates    40-42 
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Devspec  9 

Directory 

location  on  disk  2,  12 

primary  and  extended  entries 14 

16,20 

record,  locating  a    20 

records  (DIREC)   13-16 

sectors,  number  of   14 

Directory  Entry  Code  (DEC)    18-19 

20,24 

@DIRRD    73 

DIR/SYS     5 

@DIRWR  74 

Disk,  diskette 

controller  12 

double-sided    11-12,  17,  18 

files    13-14 

floppy  1 

formatting   17,  18 

hard   2 

I/O  table    13 

minimum  configuration  7-8 

name   18 


Software  217 


Index 


Subject  Page 
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@DIV8   75 

@DIV16   76 

@DODIR    77-78 

Drive 

access  1 1  -22 

address  12 

floppy 1 ,  11 

hard  2,  1 1 

size    11 

Drive  Code  Table  DCT   11-13 

Driver  —  see  Device  driver 

@DSP    79 

@DSPLY    80 

End  of  File  (EOF)    15 

Ending  Record  Number  (ERN)   16,  25 

ENTER  detection  29-32 

Error 

codes  and  messages  193-197 

dictionary    6 

@ERROR    81 

@EXIT   82 

Extended  Command  Interpreter   84,  215 

@FEXT    83 

File 

access  4 

descriptions,  TRSDOS  5-8 

modification    15 

File  Control  Block  (FCB)    23 

Files 

CREATEd    15 

device  driver    7 

filter    7 

system  (/SYS)    5-6,  7-8,  19 

utility    7 

Filter  templates 40-42 

Filters  7,  8,  40-42 

example  of   42 

FLAGS   28,  84-86 

@FNAME    87 

@FSPEC   89 

@GET    40-42,  90 

Gran,  granule 

allocation  information   25 

definition   2,  17 

per  track   1-2,  12 

Granule  Allocation  Table  (GAT) 

location  on  disk   2 
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contents  of   16-18 
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characters,  printing  190 

codes 205-06,  208 

@GTDCB    91 

@GTDCT    92 

@GTMOD   93 

Guidelines,  programming   27-44 
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@HDFMT    94 

@HEXDEC    95 
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@ICNFG,  interfacing  to    32-33 

Immediate  Execution  Program    215 

@INIT 99 

Initialization  configuration 

vector    32-33 

Interrupt  tasks 34-36 

@IPL    100 

Job  Control  Language  (JCL)  6,  28 

@KBD    101 

@KEY    102 

Keyboard  codes  21 1  -1 2 

@KEYIN    103 

KFLAG$  29 

@KITSK,  interfacing  to  33-34 

@KLTSK    104 

Library  commands  28 

technical  information  on 189-91 

@LOAD   105 

@LOC    106 

@LOF    107 

LOG  utility  190 

@LOGER    108 

Logical  Record  Length  (LRL)    1 5,  24 

@LOGOT    109 

Memory  banks  —  see  RAM  banks 

Memory  header   10,  27 

Memory  map 1 99 

Minimum  configuration  disk  7 

Modification  date    15 

@MSG  110 

@MUL8   111 

@MUL16   112 

Next  Record  Number  (NRN)   24 


o 


Software  218 


Index 


Subject  Page 
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System 
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Task  Control  Block  (TCB)  34,  35,  49 
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TRSDOS 
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